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About This Book 


Who Can Use This Book 


This book is for anyone installing the Solaris™ operating environment on 
networked or non-networked systems. Site policy and / or level of expertise 
will determine who can perform the tasks required to install Solaris software. 


Don't Read the Entire Book! 

Because this book covers different ways of installing the Solaris software to 
accommodate a variety of site needs, you do not need to read the entire book. 

Read chapters 1 and 2 — they'll help you decide which method of installing is 
best for your site, and point you to a task map that tells you exactly what 
sections of the book to use. 


IX 



How This Book Is Organized 

This book is organized by tasks in the categories of before, during, and after 
installing Solaris software. 


Note - This book does not include instructions for setting up system hardware 
or other peripherals. Setting up hardware and peripherals is described in your 
hardware guides. 


Before Installing Solaris 

1 About Installing Solaris 

2 Preparing to Install Solaris 

3 Preparing to Install Solaris Over a Network 

4 Preparing for Custom JumpStart™ Installations 

5 Using Optional Custom JumpStart Features 

6 Preparing a System for Upgrade 


■ Installing Solaris 

7 Installing Solaris: JumpStart 

8 Installing Solaris: Interactive 

9 Installing Solaris: Custom JumpStart 

After Installing Solaris 

10 Completing an Upgrade 

11 Where To Go After Installing Solaris 
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Related Information 



You may need to refer to the following books or online information when 
installing Solaris software: 

• Hardware vendor online and hardcopy documentation 
Vendor-specific information for installing Solaris software. 

• Installation Notes 

Describes any late-breaking news about installing Solaris software including 
known problems. 

• Solstice AdminSuite 2.1 User's Guide 

Describes applications such as Solstice™ Host Manager, which you can use 
if you're setting up network installations. 

• System Administration Guide , Volume 1 
Describes how to back up system files. 

• Solaris 1.x to Solaris 2.x Transition Guide 

Describes transition issues including backing up 4.1.x files before installing 
Solaris software, and restoring files after Solaris software is installed. 


About This Book 


xi 



xii 
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About Installing Solaris 



Definition: Installing Solaris Software 

As shown on the following pages, the process of installing Solaris software 
means copying it from the Solaris CD to a system's local disk. 


1 




Stage 


Diagram 


What Happens 


1 


Operating system 

^^SinOS™ .. 


Applications DeskSet 
software implementing 
the OPEN LOOK® 
graphical user interface 


Networking 

ONC™/NFS® 


The Solaris installation 
progranri for installing 
Solaris Software 


Windowing Environment 
OpenWindows™ 


You choose a Solaris CD for 
your hardware platform. The 
Solaris CD contains the 
SunOS operating system and 
other software. 
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You load the Solaris CD into 
the CD-ROM drive. 
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Stage 


Diagram 


What Happens 
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ok boot sd(0, 6, 2) 

Booting from: sd(0,6 / 2) 

SunOS Release x.x.x Version [UNIX (r) System 
V Release] 

Configuring /devices directory 
Configuring /dev directory 


After you power on the 
system, you boot the system 
using a boot command 
specific to your system 
hardware. (Sample screen 
shown.) 

During the booting phase, 
checks are performed on the 
hardware. 
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The Solaris Installation Program 


You are now interacting with the Solaris installa- 
tion program. The program is divided into a 
series of short sections. At the end of each sec- 
tion, you will see a summary of the choices 
you’ve made, and be given the opportunity to 
make changes. 


Continue 


Exit 


| Help | 


The Solaris installation 
program copies the Solaris 
software from the CD to the 
system's local disk. This is 
done interactively using a 
graphical (shown) or 
character interface, or 
automatically without user 
intervention. 


About Installing Solaris 
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Preparing to Install Solaris 



This chapter guides you step-by-step through making decisions and 
completing the tasks required to prepare your system to install the Solaris 
software including: 


Determine if your system is networked . 

page 6 

Determine your system type. 

page 6 

Determine if you have required hardware. 

page 9 

Plan disk space and memory requirements. 

page 9 

Back up your system. 

page 11 

Choose a method for installing Solaris software. 

page 11 

Choose a task map and complete required tasks. 

page 12 


Why You Should Not Ignore This Chapter 

Successfully installing Solaris software requires a clear sense of what you're 
doing and why, or it can become difficult. This chapter provides all the 
information you need to determine the best way to install the Solaris software 
for your site. This chapter also directs you to specific chapters of this book 
you'll need. 
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Steps to Prepare to Install Solaris 

Follow these steps before turning on your system. 


1 Determine if your system is networked. 

If your system is networked (connected to a network), an Ethernet connector or 
similar network adapter should be plugged into your system. 

2 Determine your system type. 

Before installing Solaris software, you must determine the system type which 
determines where the system gets important file systems. Using Figure 2-1 on 
page 7, choose a system type from the following lists: 

Networked systems: 

• OS server 

• Standalone system 

• Dataless client 

• Diskless client 

• AutoClient™ system 

Non-networked systems: 

• Standalone system 
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Networked systems 



OS Server 

Provides Solaris operating environment software including services and/or file sys- 
tems for systems on the network. For dataless and diskless clients, OS servers pro- 
vide the /usr file system. For diskless clients, an OS server provides root (/) and 
swap file systems. For AutoClient systems, an OS server provides all system soft- 
ware except the individual root (/) and /usr file system required for local swapping. 

Standalone system 

Has a local disk and does not require support from an OS server. 


Dataless client 

Has a local disk for root (/) and swap. Gets /usr file system from an OS server. 
Must mount /usr from a server. 


Diskless client 

Does not install Solaris software, but receives file services from an OS server, and 
does not have a local disk. 


AutoClient system 

Does not install Solaris software, but receives file services from an OS server. Has 
a local disk for swapping and caching its root (/) and /usr file systems. 


Non-networked systems 



Standalone systems 

Have local disks and file systems. 



Figure 2-1 System Types 


Preparing to Install Solaris 
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Note - A standalone system in the Solaris operating environment applies to 
both networked and non-networked systems. Whether networked or non- 
networked, a standalone system has all of its Solaris software on local hard 
disk, and does not require services from another system. 


3 If you are setting up diskless clients and/or AutoClient 
systems, and the OS server providing Solaris software is 
already installed with Solaris, do not go further in this book. 

Diskless clients and AutoClient systems do not install Solaris software; instead, 
they receive file services from an OS server. If the OS server providing Solaris 
software already has Solaris software installed, refer to the Solstice AdminSuite 
2.1 User's Guide for information on setting up diskless clients, or the Solstice 
AutoClient 1.0 Administration Guide for setting up AutoClients. 

If you do not have an OS server set up with Solaris software, continue in this 
book. 


4 If you are setting up dataless clients, determine if you 
have required software. 

If you are setting up dataless clients to boot over the network from an OS 
server, you must have the Solstice Host Manager, which comes with the 
server software. 


Note - SunSoft™ plans to remove support for the dataless client system type 
after Solaris 2.5. You can select this system type now, but in future releases you 
will need to select a different type. 


SPARC: Installing Solaris Software — November 1995 



5 Determine if you have required hardware. 


For a detailed description of hardware requirements, see your hardware 
vendor documentation. 


Table 2-1 Hardware Requirements 


Hardware 

Platform 

Minimum 

Memory 

Disk 

Interfaces 

Buses 

Device for Installing 
Solaris Software 

SPARC® 

system 1 

16 Mbytes 

• SMD 

• IPI 

• SCSI 

• VMEbus 

• Sbus 

You must have one of the 
following devices for 
installing Solaris software: 

• Local CD-ROM drive 

• Remote CD-ROM drive 
available over the network 

• Remote hard disk 
available over the network 


1. See your hardware vendor documentation for a list of supported systems. 


6 Plan disk space and memory requirements. 

There are many variables involved in determining disk space and memory 
requirements. Determining physical memory is easy — the minimum is 16 
Mbytes, but more is better. While a system requires 32 Mbytes of virtual 
memory (physical and swap file /slices), determining requirements beyond this 
is not easy; it is depends on the type of applications that are running. 
Determining disk space is also not so easy; it is depends on the following: 

• System type selected (for example, OS server, diskless client, AutoClient 
system, standalone system, dataless client) 

• Language selected (for example, Chinese, Japanese, Korean) 

• Software group selected (see following table) 


Preparing to Install Solaris 
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If You Want to Install 
This Software Group 1 ... 

Which Installs ... 

Then You'll Need 
Approximately This 
Much Disk Space For 
Domestic Solaris CD ... 

Core System Support 

The minimum software 
required to boot and run 
Solaris software. 

80 Mbytes 

End User System Support 

The core group plus the 
recommended software for 
an end user including 
Open Windows and the 
DeskSet software. 

180 Mbytes 

Developer System 
Support 

The end user software plus 
software for developing 
software including libraries, 
include files, man pages, 
and programming tools. 
Compilers and debuggers 
are not included. 

280 Mbytes 

Entire Distribution 

The entire Solaris release 
(everything on the CD). 
Compilers and debuggers 
are not included. 

350 Mbytes 


1. Another software group, entire distribution plus OEM support may also be available. It contains hardware 
support for SPARC clones. Disk space will vary from release to release. To find out if this software group is 
available for your hardware platform, see the SPARC Hardware Compatibility Guide. 


• Software packages that are selected or deselected in the software group (for 
example, you select Chinese, but deselect the 200-Mbyte font package) 

• Disks selected (for example, ten 104-Mbyte disks will waste more space 
trying to make things fit than a single 1 -GByte disk) 

• Solaris file system overhead or local file systems (for example, mail, printer 
spooling, users' personal file systems, swap space) 

• Size of other applications that are running (for example, AnswerBooks, 
SPARC compilers, FrameMaker®, IslandDraw®) 
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Depending on which installation method you choose, you can perform a "dry 
run" to determine if you have enough disk space before actually installing 
Solaris software. 

• Interactive - This method of installation lets you interactively select disks, 
locales, software, and lay out file systems; you can determine your 
requirements from a summary at the end of the session, and exit the 
program prior to installing Solaris software. 

• Custom JumpStart - This method of installation lets you run the 

pf install command to test specific installation profiles without actually 
installing the Solaris software on a system. 


7 Back up your system. 

If your system has any files on it that you want to save, make sure you perform 
a backup. The safest way to back up files is to do a level 0 dump. If you do not 
have a backup procedure in place, see System Administration Guide, Volume I for 
instructions. 


8 Choose a method for installing Solaris software. 

There are three methods for installing Solaris software: 

© JumpStart ™ — easiest method of installing Solaris software. The JumpStart 
software automatically installs a new system as a standalone (networked or 
non-networked) with Solaris software. However, not all new systems have 
the JumpStart software; see Step 1 on page 120 to find out if your system 
has JumpStart software. 

0 Interactive — easy, hands-on method of installing Solaris software. The 
Solaris installation program guides you step-by-step through identifying 
your system and installing Solaris software. You're in control all the way! 

© Custom JumpStart (formerly called auto-install) — for the advanced user with 
experience in Bourne shell scripting. By creating profiles and rules files, you 
can set up systems to automatically install Solaris software in different ways 
on different systems. This method requires up-front work before systems 
are turned on, but it's the most cost-effective way to install Solaris software 
for large, enterprise sites. You can even set up a hands-off installation where 
the user just boots the system and nothing more needs to be done! 


Preparing to Install Solaris 


11 



Methods 


Booting 


Identifying Your System 


Installing Solaris 


© JumpStart 


© Interactive 


© Custom 
JumpStart 



9 Choose a task map and complete required tasks. 

Choose the task map from the following pages that matches the method you've 
chosen for installing Solaris software: JumpStart, interactive, or custom 
JumpStart. The task maps guide you through all the tasks you need to 
complete before turning on, booting, and installing Solaris software on a 
system. 
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Task Map: JumpStart Installations 


Activity 


Description 


For Instructions, Go To 



Optional. “How to Set Up Serv- 

ers for Network Instal- 
lation of a Standalone, 
Server, or Dataless Cli- 
ent” 


Boot and install Solaris software. Chapter 7, “Booting 

and Installing Solaris: 
JumpStart” 


Figure 2-2 Task Map for JumpStart Installations 


page 31 


page 119 


Preparing to Install Solaris 
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Task Map: Interactive Installations 


Activity 


Gather information 


Save files from 
SunsOS 4.x systems 


Prepare system for 
upgrade 


Install Solaris 
software 


Description 

For Instructions, 
Go To 


Optional. 

Use worksheets to gather information that may need 
to be supplied during the Solaris installation program. 

Appendix A, “Work- 
sheets for the So- 
laris Installation 
Program” 

page 113 


SunOS 4.x system only 

Solaris 1.x to Solaris 


The upgrade option is not available for SunOS 4.x 
systems. Backup your system and follow other special 

2.x Transition Guide 


procedures. 



| Upgrade option only 

Chapter , 

page 113 

| Perform tasks such as backing up files and preserving 

“Preparing a 


local modifications. 

! 

System for 
Upgrade” 



| From another system on the network 

Set up systems (standalone, OS server, or dataless 
client) for network installations. 

Chapter 3, 
“Preparing to 
Install Solaris Over 
a Network” 

Chapter 8, 

“Booting and 
Installing Solaris: 
Interactive” 

page 17 
page 125 

From local CD-ROM 

Chapter 8, 

| page 125 

Boot and install Solaris software. 

“Booting and 



Installing Solaris: 



Interactive” 



Figure 2-3 Task Map for Interactive Installations 
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Task Map: Custom JumpStart Installation 


Activity 


Save files from 
SunOS 4.x system 


Prepare system for 
upgrade 


Set up system for 
custom JumpStart 


Install Solaris 
Software 


Description 

For Instructions, Go To 


SunOS 4.x system only 

Solaris 1.x to Solaris 2.x 


The upgrade option is not available for SunOS 4.x 
systems. Backup your system and follow other 
special procedures. 

Transition Guide 


Upgrade option only 

Chapter , “Preparing a 

page 113 

Perform tasks such as backing up files and 
preserving local modifications. 

System for Upgrade” 


Perform the following tasks: 

Chapter 4, “Preparing 

! page 47 

• Create a JumpStart directory 

Custom JumpStart 


• Enable clients to access the JumpStart directory 

• Create profiles 

• Create a rules file 

• Use check to validate the rules file 

Installations” 



From another system on the network 

Set up systems (standalone, OS server, or 
! dataless client) for network installations. 

Chapter 3, “Preparing 
to Install Solaris Over a 
Network” 

| page 17 


Chapter 9, “Booting 
and Installing Solaris: 
Custom JumpStart” 

page 131 

From local CD-ROM 

Boot and install Solaris software. 

Chapter 9, “Booting 
and Installing Solaris: 
Custom JumpStart” 

page 131 


Figure 2-4 Task Map for Custom JumpStart Installations 


Preparing to Install Solaris 
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Preparing to Install Solaris Over a 
Network 3 EE 


j How to Set Up a New System to be an Install Server 

page 22 | 

] How to Create an Install Server 

page 24 | 

| How to Create a Boot Server on a Subnet 

page 27 

| How to Set Up Servers for Network Installation of a Standalone , Server, 
| or Dataless Client 

page 31 

| How to Preconfigure Default Locale Using NIS 

page 40 | 

| How to Preconfigure Default Locale Using NIS+ 

page 43 


About Installing Solaris Over a Network 

A typical way to install Solaris software is to use the installation program to 
copy the Solaris CD shipped with your system. However, it is uncommon at 
most sites for every system to have its own local CD-ROM drive. When a 
system does not have a local CD-ROM drive, you can perform a network 
installation. Network installation means that you install software over the 
network — from a system with a CD-ROM drive to a system without a 
CD-ROM drive. 
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Note - Instructions in this chapter are valid for either an x86 or SPARC server 
being used for network installations. An x86 server can provide the Solaris CD 
image for SPARC systems, and a SPARC server can provide the Solaris CD 
image for x86 systems. 


Servers Required for Network Installation 

As shown in Figure 3-1, systems that install Solaris software over the network 

require: 

• Install server - A networked system with the CD-ROM drive that provides 
installation services for other systems. 

• Name server - A system that manages a distributed network database (such 
as NIS or NIS+) containing information about users and other systems on 
the network. 


Note - The install server and name server may be the same or separate 
systems. 


• Boot server - A system that boots the system to be installed over the 
network. A boot server and install server are typically the same system. 
However, if the system to be installed is on a different subnet than the install 
server, a boot server is required on that subnet. 

Dataless clients also require: 

• OS server - A system that provides Solaris operating environment software 
including services and/or file systems. For dataless clients, OS servers 
provide the /usr file system. 
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Name Server Install/Boot Server OS Server 



Standalone Standalone Standalone Standalone Diskless Dataless 

Figure 3-1 Network Installation Servers 


Preparing to Install Solaris Over a Network 
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Requirements for Hands-Off Network Installation 

To set up your site to install Solaris software on systems over the network with 

no user intervention, you must: 

• Use the custom JumpStart installation method. (See Chapter 4, "Preparing 
Custom JumpStart Installations/ 7 ) 

• Make sure all systems are properly configured in the name service. 
(Procedures in this chapter include information on how to add systems to 
the name service.) 

• Preconfigure network information, such as the date, time, geographic 
region, site subnet mask, and language. By using the Solstice Host Manager 
to set up a server for network installations, you automatically preconfigure 
network information. This eliminates many prompts that are otherwise 
necessary to identify the system during an installation. 
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Commands You Should Know About 

Table 3-1 shows programs available for setting up network installations. 


Table 3-1 Network Installation Commands 


Program 

Description 

setup_install_server 

A script that copies all or part of the Solaris CD onto a 
server's local disk. This enables you to perform 
network installations from the install server's disk 
instead of its CD-ROM drive. (Installing from the 
install server's disk is faster than installing from the 
server's CD-ROM drive.) See the 
setup_install_server (lm) man page for more 
information. 

Host Manager 

A graphical user interface that is available from within 
the Solstice AdminSuite (solstice). You can use 
Host Manager to specify naming services, system's IP 
and Ethernet addresses, and other information to be 
used for installations across a network. 

mount 

A command that shows mounted file systems, 
including the Solaris CD file system. See the 
mount ( 1M) page for more information. 

uname - i 

A command for determining a system's platform 
name (for example, SUNW,SPARCstation-5,). This 
information is sometimes required during installation. 
See the uname ( 1 ) man page for more information. 

reset 

A command for resetting the terminal settings and 
display. It is sometimes useful to use reset before 
booting. Or, if you boot and see a series of error 
messages about I/O interrupts, press the LI or STOP 
and A keys at the same time, and then enter reset at 
the ok or > PROM prompt. 

banner 

A command for displaying system information, such 
as model name, Ethernet address, or memory 
installed. Available only from the ok or > PROM 
prompt. 


Preparing to Install Solaris Over a Network 


21 



3 


Creating an Install Server 

If you are installing systems over the network, you must have an install 
server — a system with a CD-ROM drive or with Solaris software copied to its 
local disk. This system will provide the installation services for systems on the 
network that do not have a local CD-ROM drive. 

You can create an install server to install the following system types: 

• OS server 

• Standalone system 

• Dataless client 

This section describes how to: 

• Set up a new system to be an install server. 

• Create an install server by mounting the Solaris CD or by copying the 
Solaris CD to the install server's local disk. 


Note - If you intend to do frequent installations over the network, you should 
copy the Solaris CD image from the Solaris CD to the install server's local disk. 
Network installations from the install server's local disk are faster than from 
its CD-ROM drive. Copying Solaris CD image to the install server's disk also 
frees the CD-ROM drive for other uses. 


• Create a separate boot server (required only if systems are not on same 
subnet as the install server). 


V How to Set Up a New System to be an Install Server 

Overview - Setting up a new system to be an install server involves: 

• Installing the system hardware, including a CD-ROM drive 

• Connecting the system to a network 

• Installing Solaris software 

Follow this procedure to create an install server 

1. Install the system hardware, including a CD-ROM drive. 

Follow the hardware documentation for detailed information. 
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2. Connect the system to the network. 

Follow the hardware documentation for detailed information. 

3. Install Solaris software. 

During an interactive installation, you are prompted to select a name 
service. Follow the guidelines in the next table: 


Is a Name Service 
Running at Your Site ... 

Then ... 

Yes 

Select NIS or NIS+, whichever your site uses, when 
prompted for a name service. After the Solaris 
software is installed, go to How to Create an Install 
Server on page 24. 

No 

Select None when prompted for a name service. 
After the Solaris software is installed, go to Step 4. 


4. If you want this system to be a name server, set up a name service after 
you have installed the Solaris software. For detailed information, see the 

NIS+ and DNS Setup and Configuration Guide. 


f \ 

Task 

Complete 

V ^ 


The system is now set up so that you can make it an install server. Next, you 
must make a Solaris CD image available to other systems. To continue, go to 
the How to Create an Install Server on page 24. 
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▼ How to Create an Install Server 


Overview - Creating an install server involves: 

• Choosing a system with a CD-ROM drive to be the install server 

• Mounting the Solaris CD 

• Using the setup_install_server command to copy the Solaris CD to the 
install server's local disk (optional, but recommended) 

Follow this procedure to create an install server. 

1. On the system that is going to be the install server, log in and become 
root. 

This system must have a CD-ROM drive. 

2. Insert the Solaris CD into the CD-ROM drive. 

3. Mount the Solaris CD (if needed) and change the directory to the 
mounted CD: 


If the Install 
Server Is ... 

Then ... 

Running Volume 
Management 

cd /cdrom/cdromO/sO 

or 

cd /cdrom/cdrom0/s2 


Note: Volume Management is running if the /vol directory 
on the system contains files. Systems running Solaris 2.0 or 
2.1 do not have Volume Management. 

Not running 

Volume 

Management 

1) mount -F hsfs -o ro /dev/dsk/c0t6d0s0 /cdrom 

or 

mount -F hsfs -o ro /dev/dsk/c0t6d0p0 /cdrom 

2) cd /cdrom 

Determine your next step based on whether or not you want to copy the 
Solaris CD to the install server's local disk: 

If You ... 

Then ... 

Want to copy the Solaris CD Go to Step 5. 

Do not want to copy the Solaris CD Go to Step 7. 
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5. Use the setup_install_server command to copy the contents of the 
Solaris CD to the install server's local disk. 


# . /setup_install_server install _dir_path 


In this command, 

install_dirjpath Specifies the directory where the Solaris CD image 

will be copied. You can substitute any directory 
path. 


For example, the following command copies the Solaris CD image from the 
Solaris CD to the /export /ins tall directory on the local disk: 

. /setup_install_server /export/install 


Note - The setup_install_server command will indicate if you do not 
have enough disk space to copy the Solaris CD image from the Solaris CD. Use 
the df -kl command to determine available disk space. 


6. Type cd install_dir_path and press Return. 
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7. Determine your next step based on whether or not the install server is on 
the same subnet as the system to be installed. 


If Install Server Is ... Then ... 


On same subnet as the Go to Task Complete on page 26. 
system to be installed 


Not on the same subnet Follow the procedure How to Create a Boot Server on a 

as the system to be Subnet on page 27. You must complete this procedure 

installed when the install server is not on the same subnet as the 

system to be installed. After completing that procedure, 
go to Task Complete on page 26. 


Task 

Complete 




The install server is now created. Next, you must add information to the install 
server's configuration files so it recognizes the systems to be installed. To 
continue, go to How to Set Up Servers for Network Installation of a 
Standalone, Server, or Dataless Client on page 31. 
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T How to Create a Boot Server on a Subnet 


3 


You can install Solaris software over the network from any install server on the 

network. However, a system that will use an install server on another subnet 

requires a separate boot server on its own subnet. 

Overview - Creating a boot server involves: 

• Choosing a system with a CD-ROM drive to be the boot server for the 
subnet 

• Mounting the Solaris CD 

• Using the setup_install_server -b command to copy required 
platform information from the Solaris CD to the local disk 

Follow this procedure to set up a boot server on a subnet. 

1. On the system that will be the boot server for the subnet, log in and 
become root. 

This system must have a CD-ROM drive or an NFS mount of a Solaris CD 
image. The system must also be in the NIS or NIS+ name service. (If your 
site doesn't use the NIS or NIS+ name service, you must distribute 
information about this system by following your site's policies.) 

2. Determine your next step based on whether the boot server uses a local 
CD-ROM drive or an NFS mount of a Solaris CD image. 


If the Boot Server Uses ... 

Then ... 

Local CD-ROM drive 

1) Insert the Solaris CD into the CD-ROM drive. 

2) Go to Step 3. 

NFS mount of a Solaris 
CD image 

1) mount -F nfs -o r o server jname :path /mnt 
where server jname : path is the host name and 
absolute path to the Solaris CD image. 

2) cd /mnt 

3) Go to Step 4. 
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3. Mount the Solaris CD (if needed) and change the directory to the 
mounted CD: 


If the Boot Server 
Is ... 

Then ... 

Running Volume 

cd / cdrom/ cdromO/sO 

Management 

or 


cd /cdrom/cdrom0/s2 


Note: Volume Management is running if the /vol directory 
on the system contains files. Systems running Solaris 2.0 or 
2.1 do not have Volume Management. 

Not running 

1) mount -F hsfs -o ro /dev/dsk/cO t6d0s0 /cdrom 

Volume 

or 

Management 

mount -F hsfs -o ro /dev/dsk/cO t6d0p0 /cdrom 
2)cd /cdrom 
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4. Use the setup_install_server command to set up the boot server for 
the subnet. 

The setup_install_server command copies all supported platform 
information to the local disk. 


# . /setup_install_server -b boot_dir_path 


In this command, 

-b Specifies that the system will be set up as a boot 

server. 

boot_dir_path Specifies the directory where the platform 

information will be copied. You can substitute any 
directory path. 


For example, the following command copies platform information necessary 
for booting supported platforms over the network: 

. /setup_install_server -b /export/install 


Note - The setup_install_server command will indicate if you do not 
have enough disk space to copy the platform dependent information. Use the 
df -kl command to determine available disk space. 


/ \ 

Task 

Complete 

^ J 


The boot server is now set up to boot supported systems on a subnet. To 
continue, go to How to Set Up Servers for Network Installation of a 
Standalone, Server, or Dataless Client on page 31. 


Preparing to Install Solaris Over a Network 


29 





Setting Up Servers for Network Installation 

This section describes how to set up appropriate servers necessary to install a 
system over a network. The next table shows servers required for each system 
type you want to install. 


If System Type You Are Installing Is 1 ... 

Then You Need This Server Support ... 

Standalone system 

Install server 

OS server 

Install server 

Dataless client 

Install server and OS server 


1. Systems also require a boot server if they are on a different subnet than the install server. 


Note - When you install a server, you must allocate disk space required for the 
clients that server will support. Then, after the server is installed, you must use 
the Solstice Host Manager and add the platform support required by those 
clients. 
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▼ How to Set Up Servers for Network Installation of a Standalone, Server, 
or Dataless Client 

Once you have an install server set up, you are ready to use it to install Solaris 
software on other systems on the network. Before you can actually do that, 
however, you need to provide some basic system information about the 
systems that you are going to install. You do this by using the Solstice Host 
Manager. 


Note - SunSoft plans to remove support for the dataless client system type 
after Solaris 2.5. You can set up this system type now, but in future releases you 
will need to change it to a different type (standalone, OS server, diskless client, 
or AutoClient system.) 


The procedure to add system information about standalone systems, servers, 
and dataless clients to the install server can all be accomplished using the 
Solstice Host Manager. You simply fill out a form and apply the information 
you provide, and the Solstice Host Manager updates the appropriate files and 
name server maps or tables. 

Overview - This procedure involves: 

• Using the Solstice Host Manager to update the name service, to add 
information about the standalone, server, or dataless client to the install 
server's configuration files, and, if necessary, to set up a file server 

Follow this procedure to set up the install server to install a standalone system, 
a server, or a dataless client on the network. 

1. On the install server, log in as a user in the administration group 
(group 14). 


Caution - If your system is part of the NIS+ name service, you must run the 
Solstice AdminSuite while logged in as a user in the NIS+ admin group. 
Otherwise, you will not have permission to update configuration information 
on the name server. 


2. Start the Solstice AdminSuite with the following command. 


$ /usr/bin/solstice & 
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3. After the Solstice AdminSuite main window appears, click on the Host 
Manager icon. 

Note - If your site uses the Domain Name Service (DNS), you will have to 
modify the /etc/nsswitch. conf file and create the /etc/resolv. conf file 
manually. For detailed information, see the NIS+ and FNS Administration Guide. 

4. On the Host Manager: Select Naming Service screen, select a naming 
service and click on the Apply button. See the sample Naming Service 
screen below. 

If the Name Service Is ... Then Select ... 

NIS+ NIS+. Host Manager will update the NIS+ tables. 

NIS NIS. Host Manager will update the NIS maps. 

None None. Host Manager will store the information you 

provide in the /etc files. This will provide enough 
information for systems to boot, and to install Solaris 
software over the network. 



5. On the Host Manager main window, choose Add... from the Edit menu. 
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6. Determine your next step based on what kind of system you want to 
install. 


System to Be Installed Is ... 

Then ... 

Standalone system 

Go to Step 7. 

OS server 

Go to Step 10. 

Dataless client 

Go to Step 13. 
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7. On the Host Manager: Add Host screen, complete all fields and click on 
the OK or Apply button. 


F= 


Host Name: 
IP Address: 
Ethernet Address: 
Type - Select standalone System Type: 


Solstice Host Manager. Add 


Timezone Region: 


Install Server - If enabling remote 
install for a network installation, 
specify the install server and set 
the path to the location of the 
Solaris CD image- 

i ; 

Boot Server - If the install client is 
on a different subnet than the 
install server, specify the boot 
server that resides on the install - 
client’s subnet. 

Profile Server - If using custonrr 
JumpStart installations, specify 
the system with the custom- 
Jumpstart profiles on it. 


Timezone: 


Remote Install: 


Install Server: 


OS Release; 


Boot Server: 



Mountain O 


H Enable Remote Install 


pluto o 


Set Path. 


Remote Install - Select if setting 
-up a network installation. The 
install server should have been 
set up already. 


o 


none o 


Profile Server: 


none O 


i 


ran 


Apply 


\ Reset I 

Si,.,.. I 


Cancel 


Help 


8. On the Host Manager main window, choose Save Changes from the File 
menu. 

9. Go to Task Complete on page 37. 

Step 10 through Step 13 are only required if you are adding an OS server or 
dataless client. 
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10. On the Host Manager: Add Host screen, complete all fields and click on 
the OK or Apply button. 

CP- 


Type - Select OS server. - 


Solstice Host Manager: Add 


Host Name: 
IP Address: 
Ethernet Address: 


System Type: 1 OS server o 


Install Server - If enabling remote 
install for a network installation, 
specify the install server and set 
the path to the location of the 
Solaris CD image- 

Boot Server - If the install client is 
on a different subnet than the 
install server, specify the boot 
server that resides on the install- 
client’s subnet. 

Profile Server - If using custorrr 
JumpStart installations, specify 
the system with the custom" 
Jumpstart profiles on it. 


Timezone Region: 
Timezone: 


United States o 


Mountain O 


Remote Install: BsJ Enable Remote Install- 
- Install Server: 


pluto o 


Set Path... 


Remote Install - Select if setting 
-up a network installation. The 
install server should have been 
set up already. 


OS Release: o 


Boot Server: none o 


Profile Server: 


none o 


L 


"qkI I [Apply] 


Reset 


Cancel 


Help 


11. On the Host Manager main window, choose Save Changes from the File 
menu. 

12. Go to Task Complete on page 37. 

Step 13 is required only for adding dataless clients for network installation. 
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13. On the Host Manager: Add Host screen, complete all fields and click on 
the OK or Apply button. 


P - 


Solstice Host Manager: Add 




Host Name: 
IP Address: 
Ethernet Address: 


System Type: 



Timezone Region: 


United States O 


Timezone: 


OS Release - Select the OS 
Release you want installed on 
the dataless client. The proper 
OS support must reside on the 
install server. (You set up this 
support by using Host Manager 
after the server has been 
installed. This is referred to as 
“adding services.” 


File Server: 

— OS Release: 
Remote Install: 
Install Server: 

Boot Server: 


Mountain O 


pluto o 


spare sun4c Solans 2.4 O 


File Server - Specify the system 
that you want to provide /usr 
file systems for the dataless 
client. 


El Enable Remote Install 


pluto o 


Set Path... 


none o 



Profile Server: 

| none oj I 








OK || j Apply | Reset] [cancel Help 

k_ 


i 


14. On the Host Manager main window, choose Save Changes from the File 
menu. 
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f \ 

Task 

Complete 

\ 


The standalone system, OS server, or dataless client is now added for network 
installation. You are now ready to boot and install over the network. To find 
the correct booting and installing procedure in this book, see the appropriate 
chapter for the installation you want to perform: 


• Chapter 7, "Booting and Installing Solaris: JumpStart" 

• Chapter 8, "Booting and Installing Solaris: Interactive" 

• Chapter 9, "Booting and Installing Solaris: Custom JumpStart" 


Using add_install_client to Set Up Servers for Network Installation 

Install servers running versions of Solaris released prior to Solaris 2.4 software 
may not have access to the Solstice AdminSuite. You can install the Solstice 
products on Solaris 2.3 and 2.4 systems and follow the instructions in How to 
Set Up Servers for Network Installation of a Standalone, Server, or Dataless 
Client on page 31. Alternatively, you can use the add_install_client 
command to set up the install server for network installations, as described in 
the next section. 
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▼ How to Use add_instaii_ciient to Set Up Servers for Network 
Installation 


Use the add_install_client command to add information about the 
system to be installed to the boot server configuration files. 


# . /add_install_client [-c server :jumpstart_dir_path] -s install_server : install _dir_path host _name platform_group 


In this command, 

-c Specifies a JumpStart directory for custom 

JumpStart installations. This option and its 
arguments are required only for custom JumpStart 
installations. 

server :jumpstart_dir_path server is the host name of the server on which the 

JumpStart directory is located. jumpstart_dir_path 
is the absolute path of the JumpStart directory. 

-s Specifies the install server. 

install_server : install_dir_path install_server is the host name of the install server. 

install_dir_path is the absolute path name of the 
mounted Solaris CD or the directory that has the 
copy of the Solaris CD image. 

host_name Is the host name of the standalone system or the 

server where Solaris software will be installed 
over the network. (This is not the host name of the 
install server). The host must be in the name 
service for this command to work. 

platform group Is the platform group of the system to be installed. 

(For a detailed list of platform groups. See 
Appendix C, "Platform Names and Groups.") 

For example, the following command copies boot information from Solaris CD 

image on an install server's local disk in /export /ins tall . 

add_install__client sets up the /tf tpboot directory on the local system. 
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which will be the boot server. The system that will be installed is named 
basil, and it is a SPARCstation™ 10. The platform group for a SPARCstation 
10 is sun4m. 

/add__install_client -s install_serverl : /export/install basil sun4m 


/ \ 

Task 

Complete 


The standalone system, server, or dataless client is now added for network 
installation. You are now ready to boot and install over the network. To find 
the booting and installing procedure in this book, see the appropriate chapter 
for the installation you want to perform: 


• Chapter 7, "Booting and Installing Solaris: JumpStart" 

• Chapter 8, "Booting and Installing Solaris: Interactive" 

• Chapter 9, "Booting and Installing Solaris: Custom JumpStart" 
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Preconfiguring the Default Locale 

When installing a localized version of Solaris software, you are prompted for 
the locale (the language) you want to use for the duration of the installation 
process. The locale you choose for installing Solaris software is also the default 
locale the installed version of Solaris will provide to the system's user. 

You can set up a default locale of your choice. You do this by modifying the 
naming service (NIS or NIS+). After you modify the name service, as described 
in this section, the operating system will use this default locale for users. Also, 
the installation software will use the default locale for all future installations. 

Choose from the following two procedures, depending on whether your site 
uses the NIS or NIS+ name service. 


T How to Preconfigure Default Locale Using NIS 

Overview - The procedure to preconfigure the default locale at sites using the 
NIS name service involves: 

• Using the vi or text editor to edit files in the /var/yp/Makef ile file 

• Creating a locale file in the /etc directory 

• Updating the NIS maps 

Follow these instructions to set up a default locale for the system being 
installed over the network. 
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1. On the name server, log in and become root and edit the 

/var/yp/Makef ile file. 

Add the following text after the other * . time entries. 


locale . time : 
-@if 


else 

fi 


$ (DIR) /locale 

[ -f $ (DIR) /locale ]; then \ 

sed -e "/ A #/d" -e s/#.*$$// $ (DIR) /locale \ 

I awk '{for (i = 2; i<=NF; i + +) print $$i, $$0}' 
I $ (MAKEDBM) - $ (YPDBDIR) /$ (DOM) / locale . byname ; 
touch locale. time; \ 
echo "updated locale"; \ 
if [ ! $ (NOPUSH) ]; then \ 

$ (YPPUSH) locale . byname ; \ 
echo "pushed locale"; \ 

else \ 

: ; \ 
fi \ 

\ 

echo "couldn't find $ (DIR) /locale " ; \ 


\ 

\ 


2. Edit the /var/yp/Makef ile file. 

a. Add locale to the line starting with the word all. 

b. Add locale : locale . time on a new line. 


all: passwd group hosts ethers networks rpc services protocols netgroup bootparams aliases \ 
timezone locale 
locale: locale. time 
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3. Create the file /etc/locale and make one entry for each domain. 

domainjname locale 

The entry specifies the default locale for the domain. For example, the 
following line specifies French to be the default locale for the worknet . com 
domain: 

worknet.com fr 

You can also use a host name instead of the domain name to specify the 
default locale for a particular host. For example, the following line specifies 
Korean to be the default locale for system named sherlock: 

sherlock ko 

See the table on page 44 for a list of valid locale values. 


Note - Not all locales are available on all Solaris CDs. The locale you select 
will be used for installation if it is present on the Solaris CD. 

4. 

Make the maps. 


# cd /var/yp; make 


— 

Task 

Complete 

v 


Systems in the name service are now set up to use the default locale. The 
default language you have specified will be used during the installation and 
will also be the language provided to system users. 
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V How to Preconfigure Default Locale Using NIS+ 

Overview - The procedure to preconfigure the default locale at sites using the 
NIS+ name service involves: 

• Using the nistbladm command to create a locale table and add 
information to it 

• Updating the NIS+ tables 


Note - The installation software is not translated to the Asian locales, so this 
procedure will not work for any of the Asian locales. 


Follow these instructions to set up a default locale for a system being installed 
over the network. (This procedure assumes the NIS+ domain is set up. Setting 
up the NIS+ domain is documented in the NIS+ and FNS Administration Guide.) 

1. Log in to a name server as root or as a user in the NIS+ admin group. 

2. Use the following nistbladm command to create the locale table. 


# nistbladm -D access=og=rmcd, nw=r -c locale_tbl 
name=SI , nogw= locales, nogw= comments , nogw= 
locale. org_dir. 'nisdefaults -d' 
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3. Add an entry to the locale . org_dir table by typing the following 
nistbladm command. 


# nistbladm -a 

nam e=domain_name local e=locale 

comment ^comment 

locale . org_dir . 

' nisdefaults -d' 


In this command. 



domain_name 

Is either the domain name or 

a specific host name 


for which you want to preconfigure a default 


locale. 


locale 

Is the locale you want to use to install the system 
and the locale you want to come up on users' 
systems. The following table shows valid values 


for locale. 



Language 

Valid locale Values 


Chinese 

zh 


English (Solaris default) 

C 


French 

f r 


German 

de 


Italian 

it 


Japanese 

j a 


Korean 

ko 


Latin American 

es 


Swedish 

sv 


Taiwanese 

zh_TW 

comment 

Is the comment field. Use double quotation marks 
to begin and end comments that are longer than 


one word. 


Note - Not all locales are available on all Solaris CDs. The locale you select 
will be used for installation if it is present on the Solaris CD. 
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/ \ 

Task 

Complete 

V* > 


Systems in the name service are now set up to use the default locale. The 
default language you have specified will be used during the installation and 
will also be the language provided to system users. 
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Preparing Custom JumpStart 
Installations 4 EE 


How to Create a JumpStart Directory on a Diskette for x86 Systems 

page 53 

How to Create a JumpStart Directory on a Diskette for SPARC Systems 

page 59 

How to Create a JumpStart Directory on a Server 

page 63 

How to Enable All Systems to Access the JumpStart Directory 

page 65 

I How to Create a Profile 

page 67 

How to Create the rules File 

page 83 

How to Use check to Validate the rules File 

page 94 


Definition: Custom JumpStart Installation 

A custom JumpStart installation is a type of installation in which the Solaris 
software is automatically installed on a system based on a user-defined profile. 
You can create customized profiles for different types of users. 


Note - Appendix D, "Sample Custom JumpStart Installation" provides an 
example of how a fictitious site is prepared for custom JumpStart installations. 
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Note - Instructions in this chapter are valid for either an x86 or SPARC server 
that is being used for custom JumpStart installations. An x86 server can 
provide custom JumpStart files for SPARC systems, and a SPARC system can 
provide custom JumpStart files for x86 systems. 


Reasons to Choose a Custom JumpStart Installation 

You should choose custom JumpStart installations when you have to install 
Solaris software on: j 

• Many systems. 

• Particular groups of systems. 

For example, the following scenario would be ideal for performing custom 
JumpStart installations: 

• You need to install the Solaris software on 100 new systems. 

• The engineering group owns 70 out of the 100 new systems, and its systems 
must be installed as standalone systems with the developer software group. 

• The marketing group owns 30 out of the 100 new systems, and its systems 
must be installed as standalone clients with the end user software group. 

These installations would be time-consuming and tedious if you chose to 
perform an interactive installation on each system. 
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Tasks to Prepare for Custom Jump Start Installations 

Table 4-1 shows the tasks that are required to prepare for custom JumpStart 
installations. 

Table 4-1 Tasks to Prepare for Custom JumpStart Installations 


Task 

Creating a JumpStart 
directory on a diskette or 
on a server 


Enabling all clients to 
access the JumpStart 
directory 


Creating profiles 


Creating a rules file 





% 

0 


noj 



Or 

© 




. r — ~dp 





Description 

You must create a JumpStart directory to hold the custom 
JumpStart files. If you are going to use a diskette for 
custom JumpStart installations, see "Creating a JumpStart 
Directory on a Diskette" on page 53. If you are going to 
use a server for custom JumpStart installations, see 
"Creating a JumpStart Directory on a Server" on page 62. 


When you use a server to provide the JumpStart directory, 
you can enable all clients to access the JumpStart directory. 
See "Enabling All Systems to Access the JumpStart 
Directory" on page 65 for detailed information. 


keyword I 
keyword f 
keyword j 

_________ | 

Profile 


A profile is a text file used as a template by the custom 
JumpStart installation software. It defines how to install 
the Solaris software on a system (for example, initial or 
upgrade installation option, system type, disk partitioning, 
software group), and it is named in the rules file. See 
"Creating a Profile" on page 67 for detailed information. 



rule 2 1 

rule 3 I 

rules File 


The rules file is a text file used to create the rules . ok 
file. The rules file is a look-up table consisting of one or 
more rules that define matches between system attributes 
and profiles. See "Creating the rules File" on page 82 for 
detailed information. 


Using check to validate 
the rules file 



The rules . ok file is a generated version of the rules file, 
and it is required by the custom JumpStart installation 
software to match a system to a profile. You must use the 
check script to create the rules . ok file. See "Using check 
to Validate the rules File" on page 93 for detailed 
information. 
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What Happens During a Custom Jump Start Installation 

Figure 4-1 describes what happens after you boot a system to perform a 
custom JumpStart installation. 



Figure 4-1 What Happens During a Custom JumpStart Installation 
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Figure 4-2 is an example of how a custom JumpStart installation works on a 
standalone, non-networked system using the system's diskette drive. 


Pete's System 



Figure 4-2 How a Custom JumpStart Installation Works: Non-Networked Example 
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O After a system boots, the 
Solaris installation pro- 
gram finds a rules. ok file 
on designated server. 


© Solaris installation pro- 
gram finds a matching rule 
for the specific system. 


© The matched rule speci- 
fies a profile to use for 
installing the Solaris soft- 
ware on a that system. 


Figure 4-3 is an example of how a custom JumpStart installation works for 
multiple systems on a network where different profiles are accessed from a 
single server. 



Figure 4-3 How a Custom JumpStart Installation Works: Networked Example 
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Creating a JumpStart Directory on a Diskette 

You should use a diskette for a custom JumpStart installation if the system: 

• Has a diskette drive 

• Has a local CD-ROM drive 

• Is not connected to a network 

When you use a diskette for custom JumpStart installations, the JumpStart 
directory must be the root directory on the diskette that contains all the 
essential custom JumpStart installation files (for example, the rules file, 
rules . ok file, and profiles). The JumpStart directory should be owned by root 
and have permissions equal to 755. 

The diskette requirements for the JumpStart directory are different for x86 and 
SPARC systems. So, the following pages describe how to create a JumpStart 
directory on a diskette for an x86 system and for a SPARC system. 


▼ How to Create a JumpStart Directory on a Diskette for x86 Systems 

Overview - The procedure to create a JumpStart directory on a diskette for x86 
systems involves: 

• Making a copy of the Solaris boot diskette (the copied Solaris boot diskette 
has a PCFS file system) 

• Copying sample custom JumpStart installation files into the diskette's root 
directory 

Follow this procedure to create a JumpStart directory on a diskette for x86 
systems. 

1. Log in as root on an x86 or SPARC system that has a diskette drive and a 
CD-ROM drive. 

2. Insert the Solaris boot diskette into the diskette drive. 
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3. Choose the appropriate steps, depending on whether or not the system is 
running Volume Management: 


If the System Is ... 

Then ... 

Running Volume 
Management 

Go to Step 4. 


Note: Volume Management is running if the /vol 
directory on the system contains files. Systems running 
Solaris 2.0 or 2.1 do not have Volume Management. 

Not running Volume 
Management 

Go to Step 12. 


4. Make sure Volume Management knows about the diskette: 



bootjmage Is the file name where the Solaris boot diskette 

image is copied. You can specify an absolute path 
name. 

For example, the following command would copy a Solaris boot diskette to 
the boot_save file. 

dd if =/vol/dev/aliases/f loppyO of =boot_save 
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6. Eject the Solaris boot diskette: 


Note - The following command is not required for x86 systems; you must 
manually eject the diskette on an x86 system. 


# eject floppy 


7. Insert a blank diskette into the diskette drive. 

8. Make sure Volume Management knows about the diskette: 



# volcheck 

9. 

Format the diskette: 

Caution - This step will overwrite any data on the diskette. 


# fdformat -d -U 


10. Copy the Solaris boot diskette image from the system's hard disk to the 
formatted diskette: 


# dd if =boot_image of =/vol/dev/aliases/f loppyO 


The boot_image variable should be the same as in Step 5. 

11. Go to Step 17. 

Step 12 through Step 16 are used if the system is not running Volume 
Management. 
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12. Copy the Solaris boot diskette image to the system's hard disk: 





In this command, 

boot_image Is the file name where the Solaris boot diskette 

image is copied. You can specify an absolute path 
name. 

For example, the following command would copy a Solaris boot diskette to 
the boot_save file. 

dd if =/dev/rdiskette of=boot_save 

13. Eject the Solaris boot diskette: 

Note - The following command is not required for x86 systems; you must 
manually eject the diskette on an x86 system. 



14. Insert a blank diskette into the diskette drive. 

15. Format the diskette: 

Caution - This step will overwrite any data on the diskette. 
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16. Copy the Solaris boot diskette image from the system's hard disk to the 
formatted diskette: 

# dd if =boot_image of =/dev/rdiskette 

The boot_image variable should be the same as in Step 12. 

17. Mount the diskette: 


If the System Is ... 

Then ... 

Running Volume 

1) Eject the copied Solaris boot diskette. 

Management 

2) Insert the copied Solaris boot diskette back into the 
diskette drive. 

3) Make sure Volume Management knows about the 
diskette: 

volcheck 

Not running Volume 
Management 

mount -F pcf s /dev/diskette jump_dirjpath 

Note: jump_dir_path is the absolute directory path where 
the diskette is mounted. 


18. Determine your next step based on where the Solaris CD is located. 


If You Want to Use The ... 

Then ... 

Solaris CD in the local 
CD-ROM drive 

1) Insert the Solaris CD into the CD-ROM drive. 

2) Go to Step 19. 

Solaris CD image on local 
disk 

1) Change the directory to the Solaris CD image on the 
local disk. For example: 

cd /export/ install 

2) Go to Step 20. 
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19. Mount the Solaris CD (if needed) and change the directory to the 
mounted CD: 


If the System Is ... 

Then ... 

Running Volume 

cd /cdrom/cdromO/sO 

Management 

or 


cd /cdrom/cdrom0/s2 

Not running Volume 

l)mount -F hsfs -o ro /dev/dsk/c0t6d0s0 /cdrom 

Management 

or 


mount -F hsfs -o ro /dev/dsk/c0t6d0p0 /cdrom 
2)cd /cdrom 


20. Copy the JumpStart installation files from the auto_install_sample 
directory on the Solaris CD into the JumpStart directory (root directory) of 
the diskette: 


If the System Is ... Then ... 

Running Volume cp -r auto_install_sample/* /f loppy / f loppy 0/ . 

Management 

Not running cp -r auto_install_sample/* jumpstart_dir_path 

Volume 

Management Note: jump_dir_path is the absolute directory path where the 

diskette is mounted. 



Caution - File names on PCFS file systems can be only 11 characters long (an 
8-character file name and a 3-character extension). When copying JumpStart 
installation files to a diskette for x86 systems, be aware that the file transfer 
may truncate file names. 


Note - The custom JumpStart installation files must be in the root directory of 
the diskette. 

f \ 

Task 

Complete 

^ ^ I ^ 

You have completed creating a JumpStart directory on the diskette. To 
continue, see "How to Create a Profile" on page 67. 
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T How to Create a JumpStart Directory on a Diskette for SPARC Systems 


Overview - The procedure to create a JumpStart directory on a diskette for 
SPARC systems involves: 

• Formatting a diskette (if needed). 

• Creating a UFS file system on the diskette (if needed). 

• Copying sample custom JumpStart installation files into the diskette's root 
directory. 

Follow this procedure to create a JumpStart directory on a diskette for SPARC 
Systems. 

1. Log in as root on a SPARC system that has a diskette drive and a 
CD-ROM drive. 

2. Insert a diskette into the diskette drive. 

3. Choose the appropriate steps, depending on whether or not the system is 
running Volume Management: 


If the System Is ... 

Then ... 

Running Volume 
Management 

Go to Step 4. 


Note: Volume Management is running if the /vol 
directory on the system contains files. Systems running 
Solaris 2.0 or 2.1 do not have Volume Management. 

Not running 
Volume 

Go to Step 12. 

Management 



4. Make sure Volume Management knows about the diskette: 


# volcheck 
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5. If the diskette already has a UFS file system on it, go to Step 16. 

To find out if the diskette has a UFS file system on it, check the 
/etc/mnttab file for an entry similar to this: 

/ f 1 oppy / unname d_ f 1 oppy u f s 

6. Format the diskette: 


Caution - This step will overwrite any data on the diskette. 


# fdformat -U 


7. Create a UFS file system on the diskette: 


# newfs /vol/dev/aliases/f loppyO 


8. Eject the diskette: 


# eject floppy 

9. Insert the formatted diskette back into the diskette drive. 

10. Make sure Volume Management knows about the diskette: 

# volcheck 


11. Go to Step 16. 

Step 12 through Step 15 are used if the system is not running Volume 
Management. 

12. If the diskette already has a UFS file system on it, go to Step 15. 

If the mount command fails in Step 15, the diskette does not have a UFS file 
system on it. 
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13. Format the diskette: 


4 



Caution - This step will overwrite any data on the diskette. 



In this command, 

jumpstart_dir__path Is the absolute directory path where the diskette is 
mounted. 

For example, the following command would mount a SPARC diskette on the 
/mnt directory: 

mount -F ufs /dev/rdiskette /mnt 


Note - If the mount command fails, go back to Step 13 to format the diskette. 


16. Determine your next step based on where the Solaris CD is located. 


If You Want to Use The ... 

Then ... 

Solaris CD in the local 
CD-ROM drive 

1) Insert the Solaris CD into the CD-ROM drive. 

2) Go to Step 17. 

Solaris CD image on the 
local disk 

1) Change the directory to the Solaris CD image on the 
local disk. For example: 

cd /export/install 

2) Go to Step 18. 
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17. Mount the Solaris CD (if needed) and change the directory to the 
mounted CD: 


If the System Is ... 

Then ... 

Running Volume 
Management 

cd /cdrom/cdromO/sO 

or 

cd /cdrom/cdrom0/s2 

Not running Volume 
Management 

1) mount -F hsfs -o ro /dev/dsk/c0t6d0s0 /cdrom 

or 

mount -F hsfs -o ro /dev/dsk/c0t6d0p0 /cdrom 

2) cd /cdrom 

18. Copy the custom JumpStart installation files from the 

auto_install_sample directory on the Solaris CD into the JumpStart 
directory (root directory) of the diskette: 

If the System Is ... 

Then ... 

Running Volume 
Management 

Not running Volume 
Management 

cp -r auto_install_sample/* /f loppy/ floppyO/ . 

cp -r auto_install_sample/* jumpstart_dir_path 

Note: jump_dir_path is the absolute directory path where the 
diskette is mounted. 


Note - The custom JumpStart installation files must be in the root directory of 
the diskette. 


You have completed creating a JumpStart directory on the diskette. To 
continue, see "How to Create a Profile" on page 67. 


Creating a JumpStart Directory on a Server 

If you want to perform custom JumpStart installations by using a server on the 
network, you must create a JumpStart directory on the server. When you use a 
server for custom JumpStart installations, the JumpStart directory is a directory 
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on the server that contains all the essential custom JumpStart files (for 
example, the rules file, rules . ok file, and profiles). The JumpStart directory 
should be owned by root and have permissions equal to 755. 

T How to Create a JumpStart Directory on a Server 

Overview - The procedure to create a JumpStart directory on a server involves: 

• Creating a directory on the server 

• Editing the /etc/df s/df stab file 

• Copying sample custom JumpStart installation files into the directory on the 
server 

Follow this procedure to create a JumpStart directory on a server. 

1. Log in as root on the server where you want the JumpStart directory to 
reside. 

2. Create the JumpStart directory anywhere on the server: 

# mkdir jumpstart_dir_path 

In this command, 

jumpstart_dir_path Is the absolute path of the JumpStart directory. 

For example, the following command would create the directory called 
jumps tart in the root file system: 

mkdir /jumps tart 

3. Edit the /etc/df s/df stab file. Add the following entry: 

share -F nfs -o ro,anon=0 jumpstart_dirjpath 

For example, the following entry would be correct for the example shown in 
Step 2: 

share -F nfs -o ro,anon=0 /jumpstart 
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4. Type unshareall and press Return. 

5. Type shareall and press Return. 

6. Determine your next step based on where the Solaris CD is located. 


If You Want to Use The ... 

Then ... 

Solaris CD in the local 
CD-ROM drive 

1) Insert the Solaris CD into the CD-ROM drive. 

2) Go to Step 7. 

Solaris CD image on the 
local disk 

1) Change the directory to the Solaris image on the 
local disk. For example: 

cd /export/install 

2) Go to Step 8. 


7. Mount the Solaris CD (if needed) and change the directory to the 
mounted CD: 


If the System Is ... Then ... 

Running Volume cd / cdrom/ cdromO / s 0 

Management or 

cd / cdrom/ cdromO /s2 


Not running 

Volume 

Management 


Note: Volume Management is running if the /vol directory on 
the system contains files. Systems running Solaris 2.0 or 2.1 do 
not have Volume Management. 

1) mount -F hsfs -o ro /dev/dsk/cO t6d0s0 /cdrom 

or 

mount -F hsfs -o ro /dev/dsk/cO t6d0p0 /cdrom 

2 ) cd /cdrom 


8. Copy the contents of the auto_install__sample directory from the 
Solaris CD-ROM into the JumpStart directory: 


# cp -r auto_install_sample/* jumpstart_dir_path 


For example, the following command would copy the 
auto_install_sample directory into the JumpStart directory created in 
Step 2: 
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cp -r auto_install_sample/* /jumps tart 


You have completed creating a JumpStart directory on the server. To continue, 
see "How to Create a Profile" on page 67. 


Enabling All Systems to Access the JumpStart Directory 

When you create a JumpStart directory on a server, you must make sure 
systems can access it during a custom JumpStart installation. There are two 
ways to do this: 

• Using the -c option of the add_install_client command every time 
you add a system for network installation. 

or 

• Enabling all systems to access the JumpStart directory. 

To save you time when adding systems for network installations, use the 
following procedure to enable all systems to access the JumpStart directory 
from a server. 


Note - The following procedure is not necessary if you are using a diskette for 
the JumpStart directory. 


/ 

Task 

Complete 

v / 


T How to Enable All Systems to Access the JumpStart Directory 

Overview - The procedure to enable all systems to access the JumpStart 
directory from a server involves: 

• Editing the /etc/bootparams file 

• Updating the name service (NIS or NIS+) with the information you've 
added to the /etc/bootparams file 

Follow this procedure to enable all systems to access the JumpStart directory 
from a server. 

1. On the NIS or NIS+ master server, log in as root. 
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2. Edit the /etc/bootparams file or create the /etc/bootparams file if it 
does not exist. Add the following entry: 


* ins tal l_conf ig =server:jumpstart_dir_path 


In this entry. 


* Is a wildcard character specifying all systems. 

server Is the host name of the server where the JumpStart 

directory is located. 

jumpstart _dir_path Is the absolute path of the JumpStart directory. 


For example, the following entry would enable all systems to access the 
/jumps tart directory on the server named sherlock: 

* install__conf ig=sherlock : / jumpstart 


Caution - Using this procedure may produce the following error message 
when booting an install client: 

WARNING: getfile: RPC failed: error 5: (RPC Timed out). 

See page 173 for more details on this error message. 


3. Update the NIS or NIS+ tables (if necessary) with the information you 
added to the /etc/bootparams files. 


If Your Site Uses ... Then ... 

NIS /var/yp/make 

NIS+ /usr/lib/nis/nispopulate -F -p /etc bootparams 

No name service Go to Task Complete on page 67. 


f \ 

Task 

Complete 
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All systems can now access the JumpStart directory. You no longer need to use 
the -c option of the add_install_client command when adding systems 
for network installations. 


Creating a Profile 

What Is a Profile 

A profile is a text file used as a template by the custom JumpStart installation 
software. It defines how to install the Solaris software on a system (for 
example, initial or upgrade installation option, system type, disk partitioning, 
software group), and it is named in the rules file. 

A profile consists of one or more profile keywords and their values. Each 
profile keyword is a command that controls one aspect of how the Solaris 
installation program will install the Solaris software on a system. For example, 
the profile keyword and value 

system_type server 

tells the Solaris installation program to install the system as a server. 


Note - If you created the JumpStart directory by using the procedures on 
page 53 or page 62, example profiles should already be in the JumpStart 
directory. 


Requirements for Profiles 

The following are requirements when creating a profile: 

• The install_type profile keyword is required. 

• Only one profile keyword can be on a line. 


T How to Create a Profile 

Overview - The procedure to create a profile involves: 
• Editing a file 
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• Selecting profile keywords and profile values to define how to install the 
Solaris software on a system 

Follow this procedure to create as many profiles as you need for your site. 

1. Open a file (the profile) and give it a descriptive name. 

You can create a new file or edit one of the sample profiles in the JumpStart 
directory you created. 

The name of a profile should reflect how it will install the Solaris software 
on a system (for example, basic_install, eng_prof ile, or 
user_prof ile). 

2. Add profile keywords and profile values to the profile. 

Be aware of these things as you edit the profile: 

• Profile Examples on page 69 provides some examples of profiles. 

• Table 4-2 on page 72 provides the list of valid profile keywords and 
values. 

• You can have as many lines in the profile as necessary to define how to 
install the Solaris software on a system. 

• You can add a comment after the pound sign (#) anywhere on a line. If a 
line begins with a #, the entire line is a comment line. If a # is specified in 
the middle of a line, everything after the # is considered a comment. Blank 
lines are also allowed in a profile. 

• The profile keywords and their values are case sensitive. 

• Profiles should be owned by root and have permissions equal to 644. 


Note - See "Using pfinstall to Test Profiles" on page 104 for detailed 
information about testing profiles. 


f Task ^ This completes the procedure to create a profile. To continue setting up for a 
Complete custom JumpStart installation, see How to Create the rules File on page 83. 

v J 
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Profile Examples 

The following profile examples describe how you can use different profile 
keywords and profile values to control how the Solaris software is installed on 
a system. See Table 4-2 on page 72 for the list of profile keywords and profile 
values. 



# profile keywords 

profile values 

o 

install_type 

ini tial_ins tall 

© 

system_type 

standalone 

0 

partitioning 

default 


f ilesys 

any 60 swap # specify size of /swap 


f ilesys 

s_ref : /usr/share/man - /usr/share/man ro 


f ilesys 

s_ref : /usr/openwin/share/man - /usr/openwin/share/man ro, quota 

© 

cluster 

SUNWCprog 

0 

package 

SUNWman delete 


package 

SUNWolman delete 


package 

SUNWxwman delete 


package 

SUNWoldem add 


package 

SUNWxwdem add 


package 

SUNWoldim add 


package 

SUNWxwdim add 


O This profile keyword is required in every profile. 

© This profile keyword defines that the system will be installed as a 
standalone system. 

© The file system slices are determined by the software to be installed 
(default value); however, the size of swap is set to 60 Mbytes and it is 
installed on any disk (any value). The standard and OpenWindows man 
pages are mounted from the file server, s_ref, on the network. 

© The developer software group (SUNWCprog) is installed on the system. 

© Because the man pages are being mounted remotely, those packages are 
selected not to be installed on the system; however, the packages containing 
the OpenLook and X Windows demo programs and images are selected to 
be installed on the system. 
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# profile keywords 

# 

profile values 


install_type 

ini tial_ins tall 


system_type 

standalone 

© 

partitioning 

default 


f ilesys 

cOtOdOsO auto / 


f ilesys 

c0t3d0sl 32 swap 

© 

cluster 

SUNWCall 


O The file system slices are determined by the software to be installed 
(default value). However, the size of root is based on the selected 
software (auto value) and it is installed on cOtOdOsO, and the size of swap is 
set to 32 Mbytes and it is installed on c0t3d0sl. 

© The entire distribution software group (SUNWCall) is installed on the 
system. 


# profile keywords 

# 

install_type 

system_type 

© fdisk 
© fdisk 
© cluster 
© cluster 


profile values 


ini tial_ins tall 
standalone 

cOtOdO 0x04 delete 
cOtOdO Solaris maxfree 
SUNWCall 
SUNWCacc delete 


© All fdisk partitions of type DOSOS16 (04 hexadecimal) are deleted from the 
cOtOdO disk. 

© A Solaris fdisk partition is created on the largest contiguous free space on 
the cOtOdO disk. 

© The entire distribution software group (SUNWCall) is installed on the 
system. 

© The system accounting utilities (SUNWCacc) are selected not to be installed 
on the system. 
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# profile keywords 

4± 

profile values 

o 

install_type 

upgrade 

© 

package 

SUNWbcp delete 

© 

package 

SUNWolman add 


package 

SUNWxwman add 


cluster 

SUNWCumux add 

© 

locale 

de 


© This profile upgrades a system (SPARC only). 

© The binary compatibility package (SUNWbcp) is selected to be deleted from 
the system or prevented from being installed. 

© This code ensures that the OpenLook and X Windows man pages and the 
universal multiplexor software are selected to be installed if they are not 
installed on the system. (All packages already on the system are 
automatically upgraded.) 

© The German localization packages are selected to be installed on the system. 
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Profile Keyword and Profile Value Descriptions 

Table 4-2 shows the profile keywords and profile values that you can use in a 
profile. 

Table 4-2 Profile Keyword and Profile Value Descriptions (1 of 10) 


Profile 

Keyword Profile Values and Description 

client_arch karchjoalue 

client_arch defines that the server will support a different platform group than it uses. If you do not 
specify client_arch, any diskless client must have the same platform group as the server. You must 
specify client_arch once for each platform group. 

Valid values for karchjoalue are sun4d, sun4c, sun4m, or i86pc. (See Appendix C, "Platform Names and 
Groups" for a detailed list of the platform names of various systems.) 

Restriction: client_arch can be used only when system_type is specified as server. 
client__root root__size 

client_root defines the amount of root space ( rootjsize in Mbytes) to allocate for each client. If you do 
not specify client_root in a server's profile, the installation software will automatically allocate 15 
Mbytes of root space per client. The size of the client root area is used in combination with the 
num_clients keyword to determine how much space to reserve for the /export/root file system. 

Restriction: client_root can be used only when system_type is specified as server, 
c 1 i en t _js wap swap_size 

client_swap defines the amount of swap space (swapjsize in Mbytes) to allocate for each diskless 
client. If you do not specify client_swap, 24 Mbytes of swap space is allocated. 

Example: client_swap 32 

The example defines that each diskless client will have a swap space of 32 Mbytes. 

Restriction: client_swap can be used only when system_type is specified as server. 

t Profile keywords that can be used for upgrading 
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Table 4-2 Profile Keyword and Profile Value Descriptions (2 of 10) 


Profile 

Keyword Profile Values and Description 

c lus ter group jname 

( use for software 

groups) 

cluster designates what software group to add to the system. The cluster names for the software 
groups are: 


Software Group 
Core 

End user system support 
Developer system support 
Entire distribution 

Entire distribution plus OEM support 


group name 
SUNWCreq 
SUNWCuser 
SUNWCprog 
SUNWCall 
SUNWCXall 


You can specify only one software group in a profile, and it must be specified before other cluster and 
package entries. If you do not specify a software group with cluster, the end user software group 
(SUNWCuser) is installed on the system by default. 

cluster^ cluster jiame [add I delete] 

(use for clusters) 

cluster designates whether a cluster should be added or deleted from the software group that will be 
installed on the system, add or delete indicates whether the cluster should be added or deleted. If you 
do not specify add or delete, add is set by default. 

cluster _name must be in the form SUNWC name. To view detailed information about clusters and their 
names, start Admintool on an installed system and select Software from the Browse menu. 


For Upgrade: 

• All clusters already on the system are automatically upgraded. 

• If you specify cluster jname add, and cluster jname is not installed on the system, the cluster is installed. 

• If you specify cluster jname delete, and cluster jname is installed on the system, the package is 
deleted before the upgrade begins. 

f Profile keywords that can be used for upgrading 


Preparing Custom JumpStart Installations 


73 



Table 4-2 Profile Keyword and Profile Value Descriptions (3 of 10) 


Profile 

Keyword 

Profile Values and Description 


dontuse 

disk name 



dontuse designates a disk that the Solaris installation program should not use when partitioning 
default is specified. You can specify dontuse once for each disk, and disk_name must be specified in 
the form crtydz or cydz, for example, cOtOdO. 


By default, the Solaris installation program uses all the operational disks on the system. 

Restriction: You cannot specify the dontuse keyword and the usedisk keyword in the same profile, 
fdisk disk name type size 

fdisk defines how the fdisk partitions are set up on an x86 system (only required for x86 systems), and 

you can specify fdisk more than once. This is what happens by default with fdisk partitions on x86 

systems: 

• All fdisk partitions on the disk are preserved unless you specifically delete them with the fdisk 
keyword (if size is delete or 0). Also, all existing fdisk partitions are deleted when size is all. 

• A Solaris fdisk partition that contains a root file system is always designated as the active partition on 
the disk (an x86 system boots from the active partition by default). 

• If no fdisk keyword is specified in a profile, the following fdisk keyword is specified during the 
installation: 

fdisk all Solaris maxfree 

• fdisk entries are processed in the order they appear in the profile. 

disk_name - Choose where the fdisk partition will be created or deleted: 

• cxtydz or cydz - A specific disk, for example, c0t3d0. 

• rootdisk - The disk where the root file system is placed during an installation, which is determined 
by the Solaris installation program (described on page 91). 

• all - All the selected disks. 

type - Choose what type of fdisk partition will be created or deleted on the specified disk: 

• Solaris - A Solaris fdisk partition (SUNIXOS fdisk type). 

• dosprimary - An alias for primary DOS fdisk partitions (not for extended or data DOS fdisk 
partitions). When deleting fdisk partitions (size is delete), dosprimary is an alias for the 
DOSHUGE, DOSOS12, and DOSOS16 fdisk types (they are all deleted). When creating an fdisk 
partition, dosprimary is an alias for the DOSHUGE fdisk partition (a DOSHUGE fdisk partition is 
created). 

f Profile keywords that can be used for upgrading 
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Table 4-2 Profile Keyword and Profile Value Descriptions (4 of 10) 

Profile 

Keyword Profile Values and Description 

fdisk diskjaame type size 

continued 

type - Choose what type of fdisk partition will be created or deleted on the specified disk: 

• DDD - A decimal fdisk partition. DDD is a decimal number (valid values are 1 through 255). 
Restriction: This value can be specified only if size is delete. 

• OxHH - A hexadecimal fdisk partition. HH is a hexadecimal number (valid values are 01 through FF). 

Restriction: This value can be specified only if size is delete. 

The following table shows the decimal and hexadecimal numbers for some of the fdisk types: 
fdisk tvpePDDHH 
DOSOS12101 
PCIXOS 202 
DOSOS16404 
EXTDOS505 
DOSHUGE606 
DOSDATA8656 
OTHEROS9862 
UNIXOS9963 

size - Choose one of the following: 

• DDD - An fdisk partition of size DDD (in Mbytes) is created on the specified disk. DDD must be a 
decimal number and the Solaris installation program automatically rounds the number up to the 
nearest cylinder boundary. If 0 is specified, it is the same as specifying delete. 

• all - An fdisk partition is created on the entire disk (all existing fdisk partitions will be deleted). 
Restriction: This value can be specified only if type is Solaris. 

• maxf ree - An fdisk partition is created in the largest contiguous free space on the specified disk. If an 
fdisk partition of the specified type already exists on the disk, the existing fdisk partition is used (a 
new fdisk partition is not created on the disk). 

Note: There must be at least one unused fdisk partition on the disk and the disk must have free space, 

or an error will occur. 

Restriction: This value can be specified only if type is Solaris or dosprimary. 

• delete - All fdisk partitions of the specified type are deleted on the specified disk. 

f Profile keywords that can be used for upgrading 
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Table 4-2 Profile Keyword and Profile Value Descriptions (5 of 10) 


Profile 

Keyword Profile Values and Description 

filesys server.path server _address mount __pt_name [mount ^options] 

(use for 

mounting remote 
file systems) 

This instance of filesys sets up the installed system to automatically mount remote file systems when 
it boots. You can specify filesys more than once. 

For Dataless Clients: Profiles for dataless clients (when system_type dataless is specified) must 
include a remote filesys entry for both the /usr file system. The following line is an example of the 
filesys entries that must be used in a profile to install the Solaris software on a dataless client: 

filesys sherlock : /export/exec/Solaris_2 . 4_sparc . all/usr - /usr 

server: - The name of the server where the remote file system resides (followed by a colon). 

path - The remote file system's mount point name, for example, /usr or /export/home. 

server _addr ess - The IP address of the server specified in server.path . If you don't have a name service 
running on the network, this value can be used to populate the /etc /hosts file with the server's host 
name and IP address. If you don't want to specify the server's IP address (if you have a name service 
running on the network), you must specify a minus sign (-). 

mount_pt_name - The name of the mount point that the remote file system will be mounted on. 

mount _options - One or more mount options (-o option of the command) that are added to the 
/etc/vfstab entry for the specified mount _pt_name. 

Note: If you need to specify more than one mount option, the mount options must be separated by 
commas and no spaces. For example: ro, quota 

t Profile keywords that can be used for upgrading 
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Table 4-2 Profile Keyword and Profile Value Descriptions (6 of 10) 


Profile 

Keyword Profile Values and Description 

filesys slice size \file_system] [optional ^parameters] 

(use for creating 
local file systems) 

This instance of filesys creates local file systems during the installation. You can specify filesys 
more than once. 

slice - Choose one of the following: 

• any - The Solaris installation program places the file system on any disk. 

Restriction: any cannot be specified when size is existing, all, free, start’.size, or ignore. 

• cwtxdysz or cxdysz - The disk slice where the Solaris installation program places the file system, for 
example, cOtOdOsO. 

• rootdisk. s n - The logical name of the disk where the installation program places the root file 
system. The s n suffix indicates a specific slice on the disk. 

size - Choose one of the following: 

• num - The size of the file system is set to num (in Mbytes). 

• existing - The current size of the existing file system is used. 

Note: When using this value, you can change the name of an existing slice by specifying file_sys tem as 
a different mount jptjaame. 

• auto - The size the file system is automatically determined depending on the selected software. 

• all - The specified slice uses the entire disk for the file system. When you specify this value, no other 
file systems can reside on the specified disk. 

• free - The remaining unused space on the disk is used for the file system. 

Restriction: If free is used as the value to filesys, it must by the last filesys entry in a profile. 

• startisize - The file system is explicitly partitioned: start is the cylinder where the slice begins; size is 
the number of cylinders for the slice. 

f Profile keywords that can be used for upgrading 
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Table 4-2 Profile Keyword and Profile Value Descriptions (7 of 10) 


Profile 

Keyword 

Profile Values and Description 



filesys 
(use for creating 
local file systems) 
continued 

slice size [file _sy stem] [optional ^parameters] 

ji Msisits 11 S 18 II 
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file_system - You can use this optional value when slice is specified as any or cwtxdysz. If file _sy stem is 
not specified, unnamed is set by default, but then you can't specify the optional jparameters value. Choose 
one of the following: 

• mount _pt_name - The file system's mount point name, for example, /var. 

• swap - The specified slice is used as swap. 

• overlap - The specified slice is defined as a representation of a disk region (VTOC value is 
V_BACKUP). By default, slice 2 is an overlap slice that is a representation of the whole disk. 

Restriction: overlap can be specified only when size is existing, all, or startsize. 

• unnamed - The specified slice is defined as a raw slice, so slice will not have a mount point name. If 
file_system is not specified, unnampd is set by default. 

• ignore - The specified slice is not used or recognized by the Solaris installation program. This could 
be used to ignore a file system on a disk during an installation, so the Solaris installation program can 
create a new file system on the same disk with the same name. 

optional_parameters - Choose one of the following: 

• preserve - The file system on the specified slice is preserved. 

Restriction: preserve can be specified only when size is existing and slice is cwtxdysz. 

• mount _options - One or more mount options (-o option of the mount (1M) command) that are added 
to the / etc /vf stab entry for the specified mount _pt_name. 

Note: If you need to specify more than one mount option, the mount options must be separated by 
commas and no spaces. For example: ro, quota 

install_type^ initial ^install I upgrade 

install_type defines whether to perform the initial installation option or upgrade option on the 
system. 

Restriction: install_type must be the first profile keyword in every profile. 

t Profile keywords that can be used for upgrading 
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Table 4-2 Profile Keyword and Profile Value Descriptions (8 of 10) 


Profile 

Keyword 

locale"*" 


Profile Values and Description 

locale_name 

locale designates that the localization packages associated with the selected software should be 
installed (or added for upgrade) for the specified locale_name. The locale_name values are the same as the 
values used for the $LANG environment variable. Solaris 2.5 supports the following localizations: 


Language 


locale name 


Chinese zh 

French fr 

German de 

Italian i t 

Japanese j a 

Korean ko 

Latin American es 
Swedish sv 

Taiwanese zh_TW 


The English localization packages are installed by default. You can specify locale once for each 
localization you need to support. 

num_clients client _num 

When a server is installed, space is allocated for each diskless client's root (/) and swap file systems. 
num_clients defines the number of diskless clients (clientjnum) that a server will support. If you do 
not specify num_clients, five diskless clients are allocated. 

Restriction: num_clients can be used only when system_type is specified as server. 

t Profile keywords that can be used for upgrading 
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Table 4-2 Profile Keyword and Profile Value Descriptions (9 of 10) 


Profile 

Keyword 

Profile Values and Description 


package^ 

package jiame [add 1 delete] 

' . ' ' : • : 


package designates whether a package should be added to or deleted from the software group that will 
be installed on the system, add or delete indicates whether the package should be added or deleted. If 
you do not specify add f delete, add is set by default. 


packagejname must be in the form SUNW name. Use the pkginfo -1 command or Admintool (select 

Software from the Browse menu) on an installed system to view detailed information about packages 

and their names. 

For Upgrade: 

• All packages already on the system are automatically upgraded. 

• If you specify packagejname add, and package_name is not installed on the system, the package is 
installed. 

• If you specify package _name delete, and packagejname is installed on the system, the package is 
deleted before the upgrade begins. 

• If you specify package_name delete, and packagejname is not installed on the system, the package is 
prevented from being installed if it is part of a cluster that is designated to be installed. 

t Profile keywords that can be used for upgrading 
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Table 4-2 Profile Keyword and Profile Value Descriptions (10 of 10) 


Profile 

Keyword Profile Values and Description 

partitioning default I existing I explicit 

partitioning defines how the disks are divided into slices for file systems during the installation. If 
you do not specify partitioning, default is set. 

default - The Solaris installation program selects the disks and creates the file systems on which to 
install the specified software, except for any file systems specified by the f ilesys keyword, rootdisk 
is selected first; additional disks are used if the specified software does not fit on rootdisk. 

existing - The Solaris installation program uses the existing file systems on the system's disks. All file 
systems except /, /usr, /usr/openwin, /opt, and /var are preserved. The installation program uses 
the last mount point field from the file system superblock to determine which file system mount point 
the slice represents. 

Restriction: When specifying the f ilesys profile keyword with partitioning existing, size must 
be existing. 

explicit - The Solaris installation program uses the disks and creates the file systems specified by the 
f ilesys keywords. If you specify only the root (/) file system with the f ilesys keyword, all the 
Solaris software will be installed in the root file system. 

Restriction: When you use the explicit profile value, you must use the f ilesys profile keyword to 
specify which disks to use and what file systems to create. 

system_type standalone I dataless I server 

system__type defines the type of system being installed. If you do not specify system_type in a 
profile, standalone is set by default. 

usedisk diskjname 

usedisk designates a disk that the Solaris installation program will use when partitioning 
default is specified. You can specify usedisk once for each disk, and diskjaame must be specified in 
the form cxtydz or cydz, for example, cOtOdO. 

If you specify the usedisk profile keyword in a profile, the Solaris installation program will only use 
the disks that you specify with the usedisk profile keyword. 

Restriction: You cannot specify the usedisk keyword and the dontuse keyword in the same profile. 

t Profile keywords that can be used for upgrading 
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How the Size of Swap Is Determined 

If a profile does not explicitly specify the size of swap, the Solaris installation 
program determines the maximum size that swap can be, based on the 
system's physical memory. Table 4-3 shows how the maximum size of swap is 
determined during a custom JumpStart installation. 


Table 4-3 How the Maximum Size of Swap Is Determined 


Physical Memory (in Mbytes) 

Maximum Size of Swap (in Mbytes) 

16 - 64 

32 

64 - 128 

64 

128 - 512 

128 

512 > 

256 


The Solaris installation program will make the size of swap no more than 20% 
of the disk where it resides, unless there is free space left on the disk after 
laying out the other file systems. If free space exists, the Solaris installation 
program will allocate the free space to swap up to the maximum size shown in 
Table 4-3. 


Note - Physical memory plus swap space must be a minimum of 32 Mbytes. 


Creating the rules File 

What Is the rules File 

The rules file is a text file used to create the rules . ok file. The rules file is 
a look-up table consisting of one or more rules that define matches between 
system attributes and profiles. For example, the rule 

karch sun4c - basic__prof - 

matches a system with a sun4c platform name to the basic_prof profile, 
which the Solaris installation program would use to install the system. 
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Note - If you set up the JumpStart directory by using the procedures on 
page 53 or page 62, an example rules file should already be in the JumpStart 
directory; the example rules file contains documentation and some example 
rules. If you use the example rules file, make sure you comment out the 
example rules that you will not use. 


When Does a System Match a Rule 

During a custom JumpStart installation, the Solaris installation program 
attempts to match the rules in the rules . ok file in order: first rule through the 
last rule. A rule match occurs when the system being installed matches any of 
the rule values in the rule (as defined in Table 4-5 on page 88). As soon as a 
system matches a rule, the Solaris installation program stops reading the 
rules . ok file and begins to install the system as defined by the matched 
rule's profile. 


T How to Create the rules File 

Overview - The procedure to create a rules file involves: 

• Editing a file 

• Selecting rule keywords and rule values for each group of systems you want 
to install using custom JumpStart. Any systems that match the rule keyword 
and rule value will be installed as specified by the corresponding profile. 

Follow this procedure to create a rules file. 

1. Open a file (the rules file) and name it rules. 

You can create a new file or edit the sample rules file provided in the 
JumpStart directory you created. 

2. Add a rule in the rules file for each group of systems you want to install 
using custom JumpStart. 

Be aware of these things as you add rules to the rules file: 

• Rule Examples on page 86 provides some examples of rules. 

• Table 4-5 on page 88 provides the list of valid rule keywords and values. 

• The rules file must have at least one rule 
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• A rule must have at least a rule keyword, a rule value, and a 
corresponding profile. 

A rule within the rules file must have the following syntax: 

[ ! ] rule_keyword rulejvalue [&& [\]rule_keyword rulejvalue] . . . begin profile finish 


Table 4-4 describes the fields of a rule. 


Table 4-4 Field Descriptions of a Rule 


Field 

Description 

I 

A symbol used before a rule keyword to indicate negation. 

[] 

A symbol used to indicate an optional expression or field. 


A symbol used to indicate the preceding expression may be 
repeated. 

rule _key word 

A predefined keyword that describes a general system 
attribute, such as host name (hostname) or memory size 
(memsize). It is used with the rule value to match a system 
with the same attribute to a profile. See Table 4-5 on page 88 for 
the list of rule keywords. 

rulejvalue 

A value that provides the specific system attribute for the 
corresponding rule keyword. See Table 4-5 on page 88 for the 
list of rule values. 

&& 

A symbol that must be used to join (logically AND) rule 
keyword and rule value pairs together in the same rule. During 
a custom JumpStart installation, a system must match every 
pair in the rule before the rule matches. 
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Table 4-4 

Field Descriptions of a Rule (Continued) 

Field 

Description 

begin 

A name of an optional Bourne shell script that can be executed 
before the installation begins. If no begin script exists, you must 
enter a minus sign (-) in this field. All begin scripts must reside 
in the JumpStart directory. 

See "Creating Begin Scripts" on page 98 for detailed 
information on how to create begin scripts. 

profile 

A name of a text file used as a template that defines how to 
install Solaris on a system. The information in a profile consists 
of profile keywords and their corresponding profile values. All 
profiles must reside in the JumpStart directory. 

Note - There are optional ways to use the profile field, which 
are described in "Using a Site-Specific Installation Program" on 
page 111 and "Creating Derived Profiles With Begin Scripts" on 
page 98. 

finish 

A name of an optional Bourne shell script that can be executed 
after the installation completes. If no finish script exists, you 
must enter a minus sign (-) in this field. All finish scripts must 
reside in the JumpStart directory. 

See "Creating Finish Scripts" on page 100 for detailed 
information on how to create finish scripts. 


This completes the procedure to create a rules file. To validate the rules file, 
see How to Use check to Validate the rules File on page 94. 



Preparing Custom JumpStart Installations 


85 



Rule Examples 

The following illustration shows several example rules in a rules file. Each 
line has a rule keyword and a valid value for that keyword. The Solaris 
installation program scans the rules file from top to bottom. When the Solaris 
installation program matches a rule keyword and value with a known system, 
it installs the Solaris software specified by the profile listed in the profile field. 



# rule keywords and rule valuesbegin script 

profile 

finish script 

© 

© 

hostname eng-1 

network 192.43.34.0 && Imodel \ 

basic_prof 

- 

© 

'SUNW, Sun 4_50 1 

net_prof 

- 

model SUNW, SPARC station- LX 

lx_prof 

complete 

© 

network 193.144.2.0 && karch i86pcsetup 

x86_prof 

done 

© 

memsize 16-32 && arch spare 

prog_prof 

- 

© 

any 

generic_prof 


O This rule matches if the system's host name is eng- 1 . The basic_prof 
profile is used to install the Solaris software on the system that matches this 
rule. 

© The rule matches if the system is on subnet 192.43.34.0 and it is not a 
SPARCstation IPX™ (SUNW, Sun 4_50). The net__prof profile is used to 
install the Solaris software on systems that match this rule. 

© The rule matches if the system is a SPARCstation LX. The lx_prof profile 
and the complete finish script are used to install the Solaris software on 
systems that match this rule. This rule also provides an example of rule 
wrap, which is defined on page 87. 

© This rule matches if the system is on subnet 193.144.2.0 and the system is an 
x86. The setup begin script, the x86_prof profile, and the done finish 
script are used to install the Solaris software on systems that match this 
rule. 

© This rule matches if the system has 16-32 Mbytes of memory and its 
processor type is SPARC. The prog_prof profile is used to install the 
Solaris software on systems that match this rule. 

© This rule matches any system that did not match the previous rules. The 
generic_prof profile is used to install the Solaris software on systems 
that match this rule. If used, any should always be in the last rule. 
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Important Information About the rules File 

The following information is important to know about the rules file: 

• Name - The rules file must have the file name, rules. 

• rules . ok file - The rules . ok file is a generated version of the rules file, 
and it is required by the custom JumpStart installation software to match a 
system to a profile. You must run the check script to create the rules . ok 
file, and the rules . ok file should be owned by root and have permissions 
equal to 644. 

• Comments - You can add a comment after the pound sign (#) anywhere on 
a line. If a line begins with a #, the entire line is a comment line. If a # is 
specified in the middle of a line, everything after the # is considered a 
comment. Blank lines are also allowed in the rules file. 


Note - When creating the rules . ok file, the check script removes all the 
comment lines, comments at the end of a rule, and blank lines. 


• Rule wrap - When a rule spans multiple lines, you can let a rule to wrap to 
a new line, or you can continue a rule on a new line by using a backslash ( \ ) 
before the carriage return. 

• Rule fields - The rulejvalue, begin, and finish fields must have a valid entry 
or a minus sign (-) to specify that there is no entry. 
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Rule Keyword and Rule Value Descriptions 

Table 4-5 describes the rule keywords and rule values that you can use in the 
rules file. 



Table 4-5 Rule Keyword and Rule Value Descriptions (1 of 4) 

Rule Keyword 

Rule Values 


Description 

any 

minus sign (-) 


Match always succeeds. 

arch 

processor _type 

platform 

SPARC 

x86 

processor type 

spare 

i386 

Matches a system's processor type. The 
uname -p command reports the system's 
processor type. 

doma inname 

domainjname 


Matches a system's domain name, which 
controls how a name service determines 
information. 




If you have a system already installed, the 
doma inname command reports the system's 
domain name. 

disksize 

disk_name size_ 

range 

Matches a system's disk (in Mbytes). 


disk_name - A disk name in the form cxtydz, such as 
c0t3d0, or the special word rootdisk. rootdisk 
should be used only when trying to match systems that 
contain the factory-installed JumpStart software, 
rootdisk is described on page 91. 

Example: disksize c0t3d0 250-300 

The example tries to match a system with a 
c0t3d0 disk that is between 250 and 300 
Mbytes. 


sizejrange - The size of the disk, which must be specified 
as a range of Mbytes (xx-xx). 

Note: When calculating sizejrange, remember 
that a Mbyte equals 1,048,576 bytes. A disk 
may be advertised as a "207 Mbyte" disk, but 
it may have only 207 million bytes of disk 
space. The Solaris installation program will 
actually view the "207 Mbyte" disk as a 197 
Mbyte disk because 207,000,000 / 1,048,576 = 
197. So, a "207 Mbyte" disk would not match a 
sizejrange equal to 200-210. 

hostaddress 

IP_address 


Matches a system's IP address. 
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Table 4-5 Rule Keyword and Rule Value Descriptions (2 of 4) 

Rule Keyword 

Rule Values 

Description 

hostname 

hostjname 

Matches a system's host name. 

If you have a system already installed, the 
uname -n command reports the system's host 
name. 

installed 

slice version 

slice - A disk slice name in the form cwtxdysz, such as 
c0t3d0s5, or the special words any or rootdisk. If any 
is used, any disk attached to the system attempts to 
match, rootdisk should be used only when trying to 
match systems that contain the factory-installed 
JumpStart software, rootdisk is described on page 91. 

version - A version name, such as Solar is_2 . 3, or the 
special words any or upgrade. If any is used, any 
Solaris or SunOS release is matched. If upgrade is used, 
any upgradable Solaris 2.1 or greater release is matched. 

Matches a disk that has a root file system 
corresponding to a particular version of 
Solaris software. 

karch 

platform _group 

Valid values are sun4d, sun4c, sun4m, or i86pc. (See 
Appendix C, "Platform Names and Groups" for a 
detailed list of platform groups and names.) 

Matches a system's platform name. 

If you have a system already installed, the 
arch -k command or the uname -m 
command reports the system's platform 
group. 

memsize 

physicaljmem 

The value must be a range of Mbytes (xx-xx) or a single 
Mbyte value. 

Matches a system's physical memory size (in 
Mbytes). 

Example: memsize 16-32 

The example tries to match a system with a 
physical memory size between 16 and 32 
Mbytes. 

If you have a system already installed, the 
prtconf command (line 2) reports the 
system's physical memory size. 
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Table 4-5 Rule Keyword and Rule Value Descriptions (3 of 4) 


Rule Keyword Rule Values 


Description 


model 


model _name 

System 
Sun-4/ 110 
Sun-4 /2xx 

SPARCstation 1 (4/60) 
SPARCstation 1+ (4/65) 
SPARCstation SLC™ (4/20) 
SPARCstation IPC (4/40) 
SPARCstation ELC™ (4/25) 
SPARCstation IPX (4/50) 
SPARCstation 2 (4/75) 
Sun-4 /3xx 
Sun-4 /4xx 
SPARCserver™ 6xx 
SPARCstation 10 
SPARCclassic™ (4/15) 
SPARCstation LX (4/30) 
SPARCcenter™ 1000 
SPARCcenter 2000 
SPARCstation 10 SX 
SPARCstation 20 
SPARCstation 5 
SPARCstation Voyager 
Sun Ultra™ 1 Model 140 
x86 


model name 

Sun 4__100 Series 

Sun 4_200 Series 

Sun 4_60 

Sun 4_65 

Sun 4_20 

SUNW,Sun 4_40 

SUN W, SUN 4_25 

SUNW,Sun 4_50 

SUNW,SUN 4_75 

Sun SPARCsystem 300 

Sun SPARCsystem 400 

SUN W,SPARCsy stem-600 

SUN W,SPARCstation-l 0 

SUNW,SPARCclassic 

SUNW,SPARCstation-LX 

SUNW,SPARCserver-1000 

SUNW,SPARCcenter-2000 

SUNW,SPARCstation-10,SX 

SUNW,SPARCstation-20 

SUNW,SPARCstation-5 

SUNW,S240 

SUNW,Ultral-140 

i86pc 


Matches a system's model number, which is 
system-dependent and varies by the 
manufacturer. The list shown may not be 
complete. 

If you have a system already installed, the 
prtconf command (line 5) reports the 
system's model number. 

Note: If the model_name contains spaces, the 
model_name must be inside a pair of single 
quotes ('). For example: 1 SUNW, Sun 4_50 1 
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Table 4-5 

Rule Keyword and Rule Value Descriptions (4 of 4) 

Rule Keyword 

Rule Values 

Description 

network 

networkjnum 

Matches a system's network number, which 
the Solaris installation program determines by 
performing a logical AND between the 
system's IP address and the subnet mask. 

Example: network 193.144.2.0 

The example would match a system with a 
193.144.2.8 IP address (if the subnet mask were 
255.255.255.0). 

osname 

Solaris jversion 

Matches a version of Solaris already installed 
on a system. Solarisjversion is the version of 
Solaris environment installed on the system: 
for example, Solaris_2.5. 

totaldisk 

sizejrange 

The value must be specified 

Matches the total disk space on a system (in 
Mbytes). The total disk space includes all the 
as a range of Mbytes (xx-xx). operational disks attached to a system. 


Example: totaldisk 3 00-500 

The example tries to match a system with a 
total disk space between 300 and 500 Mbytes. 

Note: When calculating sizejrange, remember 
that a Mbyte equals 1048576 bytes. A disk may 
be advertised as a "20 7 Mbyte" disk, but it 
may have only 207 million bytes of disk space. 
The Solaris installation program will actually 
view the "207 Mbyte" disk as a 197 Mbyte disk 
because 207000000 / 1048576 = 197. So, a "207 
Mbyte" disk would not match a sizejrange 
equal to 200-210. 


How the Installation Program Sets the Value of roo tdi sk 

rootdisk is the logical name of the disk where the root file system is placed 
during an installation. During a custom JumpStart installation, the Solaris 
installation program sets the value of rootdisk (that is, the actual disk it 
represents) depending on various situations; this is described in Table 4-6. 
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Table 4-6 How the Solaris Installation Program Sets the Value of rootdisk 


Situation 

What Happens 

A system contains the factory-installed 
JumpStart software, (this applies to 
some SPARC systems only). 

rootdisk is set to the disk that contains 
the factory-installed JumpStart software 
before the system tries to match any rules. 

rootdisk has not been set and a 
system tries to match the following 
rule: 

disksize rootdisk size_range 

or 

installed rootdisk version 

rootdisk is set to c0t3d0 or the first 
available disk attached to the system. 

After rootdisk is set, the system tries to 
match the rule. 

If rootdisk has been set and the 
system tries to match the following 
rule. 

The system tries to match the rule. 

disksize rootdisk sizejrange 

or 

installed rootdisk version 


A system tries to match the following 
rule: 

installed disk version 

If disk is found on the system with a root 
file system that matches the specified 
version, the rule matches and rootdisk is 
set to disk. 

A system tries to match the following 
rule: 

installed any version 

If any disk is found on the system with a 
root file system that matches the specified 
version, the rule matches and rootdisk is 
set to the found disk. (If there is more than 
one disk on the system that can match, the 
system will match the first disk that is 
found.) 
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Table 4-6 How the Solaris Installation Program Sets the Value of rootdisk (Continued) 


Situation 

What Happens 

rootdisk has not been set after a 
system matches a rule and the system 
is going to be upgraded (which is 
defined in the profile). 

rootdisk is set to the first disk found with 
a root file system that matches an 
upgradable version of Solaris software. If 
no disk is found, the system proceeds with 
an interactive installation. 

rootdisk has not been set after a 
system matches a rule. 

rootdisk is set to c0t3d0 or the first 
available disk attached to the system. 


For the Solaris installation program to use the value of rootdisk, the 
following conditions must be true in the profile specified for the system: 

• Default partitioning is used. 

• No slice has been explicitly set for the root file system. 

Using check to Validate the rules File 

Before the rules file and profiles can be used, you must run the check script 
to validate that these files are set up correctly. The following table shows what 
the check script does. 

Stage Description 

1 The rules file is checked for syntax. 

check makes sure that the rule keywords are legitimate, and the 
begin, class, and finish fields are specified for each rule (the begin 
and finish fields may be a minus sign [-] instead of a file name). 

2 If no errors are found in the rules file, each profile specified in 
the rules is checked for syntax. 

3 If no errors are found, check creates the rules . ok file from the 
rules file, removing all comments and blank lines, retaining all 
the rules, and adding the following comment line to the end: 

# version=2 checksum=num 
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▼ How to Use check to Validate the rules File 



Overview - The procedure to use check to validate the rules file involves: 

• Making sure the check script resides in the JumpStart directory 

• Running the check script 

Follow this procedure to use check to validate the rules file. 

1. Make sure that the check script resides in the JumpStart directory. 

Note - The check script is provided in the auto_install_sample directory 
on the Solaris CD. 

2. Change the directory to the JumpStart directory: 



3. Run the check script to validate the rules file: 



In this command. 


-p path Is the path to the Solaris 2.5 CD. You can use a 

Solaris CD image on a local disk or a mounted 
Solaris CD.This option ensures that you are using 
the most recent version of the check script. You 
should use this option if you are using check on a 
system that is running a previous version of 
Solaris. 

-r file. jname Specifies a rules file other than the one named 

rules. Using this option, you can test the validity 
of a rule before integrating it into the rules file. 
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As the check script runs, it reports that it is checking the validity of the 
rules file and the validity of each profile. If no errors are encountered, it 
reports: The auto-install configuration is ok. 


f \ 

Task 

Complete 

v J 


The rules files is now validated. To read about the optional features 
available for custom JumpStart installations, see Chapter 5, "Using Optional 
Custom JumpStart Features." To perform a custom JumpStart installation on 
a system, see Chapter 9, "Booting and Installing Solaris: Custom JumpStart." 
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Using Optional Custom JumpStart 
Features 5 EE 


How to Use pfinstall to Test a Profile 

page 105 

How to Create a Disk Configuration File for a SPARC System 

page 107 

How to Create a Multiple Disk Configuration File for a SPARC System 

page 109 


Overview 


This chapter describes the optional features available for custom JumpStart 
installations, and it is a supplement to Chapter 4, "Preparing Custom 
JumpStart Installations." You can use the following optional features to 
enhance and test custom JumpStart installations: 

• Begin scripts 

• Finish scripts 

• pfinstall 

• Site-specific installation program 


Note - This chapter is valid for either an x86 or SPARC server that is being 
used for custom JumpStart installations. An x86 server can provide custom 
JumpStart files for SPARC systems and a SPARC system can provide custom 
JumpStart files for x86 systems. 
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Creating Begin Scripts 


What Is a Begin Script 

A begin script is a user-defined Bourne shell script, specified within the rules 

file, that performs tasks before the Solaris software is installed on the system. 

Begin scripts can be used only with custom JumpStart installations. 

Important Information About Begin Scripts 

The following information is important to know about begin scripts: 

• Be careful that you do not specify something in the script that would 
prevent the mounting of file systems onto / a during an initial or upgrade 
installation. If the Solaris installation program cannot mount the file systems 
onto /a, an error will occur and the installation will fail. 

• Output from the begin script goes to /var/sadm/begin. log. 

• Begin scripts should be owned by root and have permissions equal to 644. 


Ideas for Begin Scripts 

You could set up begin scripts to perform the following tasks: 

• Creating derived profiles 

• Backing up files before upgrade 


Creating Derived Profiles With Begin Scripts 

A derived profile is a profile that is dynamically created by a begin script during 
a custom JumpStart installation. Derived profiles are needed when you cannot 
set up the rules file to match specific systems to a profile (when you need 
more flexibility than the rules file can provide). For example, you may need 
to use derived profiles for identical system models that have different 
hardware components (for example, systems that have different frame buffers). 

To set up a rule to use a derived profile, you must: 

• Set the profile field to an equal sign (=) instead of a profile. 
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• Set the begin field to a begin script that will create a derived profile 
depending on which system is being installed. 

When a system matches a rule with the profile field equal to an equal sign (=), 
the begin script creates the derived profile that is used to install the Solaris 
software on the system. 

An example of a begin script that creates the same derived profile every time is 
shown below; however, you could add code to this example that would create 
a different derived profile depending on certain command's output. 


# ! /bin/sh 





echo 

" ins tall_ type 

initial_install " 

> 

${SI_PROFILE} 

echo 

" system_type 

standalone " 

>> 

${SI_PROFILE} 

echo 

"partitioning 

default " 

>> 

$ { SI_PROFILE} 

echo 

" cluster 

SUNWCprog 11 

>> 

${SI_PROFILE} 

echo 

"package 

SUNWman 

delete " 

>> 

$ { SI_PROFILE} 

echo 

"package 

SUNWolman 

delete " 

>> 

${SI_PROFILE} 

echo 

"package 

SUNWxwman 

delete" 

>> 

$ { S I_PROFILE } 


As shown above, the begin script must use the SI_PROFILE environment 
variable for the name of the derived profile, which is set to 

/tmp/ ins tall . input by default. 


Note - If a begin script is used to create a derived profile, make sure there are 
no errors in it. A derived profile is not verified by the check script, because it 
is not created until the execution of the begin script. 
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Creating Finish Scripts 


What Is a Finish Script 

A finish script is a user-defined Bourne shell script, specified within the rules 
file, that performs tasks after the Solaris software is installed on the system, but 
before the system reboots. Finish scripts can be used only with custom 
JumpStart installations. 

Important Information About Finish Scripts 

The following information is important to know about finish scripts: 

• The Solaris installation program mounts the system's file systems onto /a. 
The file systems remain mounted on /a until the system reboots. Therefore, 
you can use the finish script to add, change, or remove files from the newly 
installed file system hierarchy by modifying the file systems respective 

to /a. 

• Output from the finish script goes to /var/sadm/ finish, log. 

• Finish scripts should be owned by root and have permissions equal to 644. 


Ideas for Finish Scripts 

You could set up finish scripts to perform the following tasks: 

• Installing patches 

• Restoring backed up files 

• Setting up print servers 

• Adding entries to the automount map 

The following finish scripts are provided as examples: 

• Adding files 

• Customizing the root environment 

• Setting the system's root password 
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Adding Files With Finish Scripts 

Through a finish script, you can add files from the JumpStart directory to the 
already installed system. This is possible because the JumpStart directory is 
mounted on the directory specified by the SI_CONFIG_DIR variable (which is 

set to / tmp/install_conf ig by default). 


Note - You can also replace files by copying files from the JumpStart directory 
to already existing files on the installed system. 


The following procedure enables you to create a finish script to add files to a 
system after the Solaris software is installed on it: 

1. Copy all the files you want added to the installed system into the JumpStart 
directory. 

2. Insert the following line into the finish script for each file you want copied 
into the newly installed file system hierarchy. 


cp $ { SI_CONFIG_DIR} /file_name / a/path_name 


For example, assume you have a special application, site_prog, developed 
for all users at your site. If you place a copy of site_prog into the 
JumpStart directory, the following finish script would copy the site_prog 
from the JumpStart directory into a system's /usr/bin directory during a 
custom JumpStart installation: 


# ! /bin/sh 

cp $ {SI__CONFIG_DIR} /site_prog /a/usr/bin 
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Customizing the Root Environment 

Through a finish script, you can customize files already installed on the 
system. For example, the following finish script customizes the root 
environment by appending information to the . cshrc file in the root directory. 


# ! /bin/sh 
# 

# Customize root's environment 

# 

echo "***adding customizations in /.cshrc" 
test -f a/ . cshrc II { 
cat >> a/. cshrc <<EOF 

set history=100 savehist=200 filec ignoreeof prompt = " \$user@'uname -n v > 
alias cp cp -i 
alias mv mv -i 
alias rm rm -i 
alias Is Is -FC 
alias h history 
alias c clear 
unset autologout 
EOF 
} 


Setting the System's Root Password With Finish Scripts 

After Solaris software is installed on a system, the system reboots. Before the 
boot process is completed, the system prompts for the root password. This 
means that until someone enters a password, the system cannot finish booting. 

The auto_install_sample directory provides a finish script called 
set_root_pw that sets the root password for you. This allows the initial 
reboot of the system to be completed without prompting for a root password. 
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The set_root_pw file is shown below. 


# I /bin/sh 
# 

# @ ( # ) set_root_pw 1.4 93/12/23 SMI 

# 

# This is an example bourne shell script to be run after installation. 

# It sets the system's root password to the entry defined in PASSWD. 

# The encrypted password is obtained from an existing root password entry 

# in /etc/shadow from an installed machine. 

echo "setting password for root" 

# set the root password 
O PASSWD=dK05IBkSF421w 

mv /a/etc/shadow /a/etc/shadow. orig 
nawk -F : 1 { 

if ( $1 == "root" ) 

© print f " %s : %s : %s : %s : %s : %s : %s : %s : %s\n" , $1 , passwd, $3,$4,$5,$6,$7,$8,$9 

else 

print f " %s:%s:%s:%s:%s:%s:%s:%s:%s\n",$l / $2,$3 / $4,$5,$6,$7 / $8,$9 
}' pas swd= "$ PASSWD" /a/etc/shadow. orig > /a/etc/shadow 

© # set the flag so sysidroot won't prompt for the root password 

sed -e 's/0# root/1# root/' $ {SI_SYS_STATE} > / tmp/state . $$ 
mv /tmp/state. $$ $ {SI_SYS_STATE} 


There are three main things you must do to set the root password in a finish 

script. 

© Set the variable PASSWD to an encrypted root password obtained from an 
existing entry in a system's /etc/ shadow file. 

© Change the root entry in the /etc /shadow file for the newly installed 
system using $ PASSWD as the password field. 

© Change the entry from 0 to a 1 in the state file, so that the user will not be 
prompted for the root password. The state file is accessed using the variable 
SI_SYS_STATE, whose value currently is /a/etc/ . sysIDtool . state. 
(To avoid problems with your scripts if this value changes, always reference 
this file using $SI_SYS_STATE.) The sed command shown here contains a 
tab character after the 0 and after the 1 . 
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Note - If you set your root password by using a finish script, be sure to 
safeguard against those who will try to discover the root password from the 
encrypted password in the finish script. 


Using pf ins tall to Test Profiles 
Why Use pf install 

When install_type ini tial_ins tall is defined in a profile, you can use 
the pf install command to test the profile without actually installing the 
Solaris software on a system^pf install shows the results of how a system 
would be installed according to the specified profile, before you actually 
perform a custom JumpStart installation. 


Note - You cannot use pf install to test a profile using the upgrade option 
(when the initial_type upgrade is defined in a profile). 


Ways to Use pf install 

pf install enables you to test a profile against: 

• The system's disk configuration where pf install is being run. 

• A disk configuration file that you can create with the prtvtoc command. A 
disk configuration file is a file that represents a structure of a disk (for 
example, bytes / sector, flags, slices). Disk configuration files enable you to 
use pf install from a single system to test profiles on different sized disks. 

You must run pf install on an x86 system to test profiles for x86 systems 
(using the x86 system's disk configuration or an x86 disk configuration file). 
Conversely, you must run pfinstall on a SPARC system to test profiles for 
SPARC systems (using the SPARC system's disk configuration or a SPARC disk 
configuration file). 
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▼ How to Use pf install to Test a Profile 

Overview - The procedure to use pf install to test a profile involves: 

• Changing the directory to the JumpStart directory 

• Using the pf install command to test the profile 

Follow this procedure to use pf install to test a profile. 

1. To test the profile with a specific system memory size, set SYS_MEMSIZE to 
the specific memory size in Mbytes: 


$ SYSJMEMSlZE=memory_size 

$ export SYS_MEMSIZE 


2. Change the directory to the JumpStart directory where the profile resides: 


$ cd jumpstart_dir_path 


For example, the following command would change the directory to the 
jumps tart directory on the root file system. 

cd /jumps tart 

3. Run the pf install -d or pf install -D command to test the profile: 



Caution - Without the -d or -D option, pfinstall will install the Solaris 
software on the system by using the specified profile, and the data on the 
system will be overwritten. 


$ /usr/sbin/install . d/pf install -D I -d disk_config [-c path] profile 


In this command, 

-D Tells pfinstall to use the current system's disk 

configuration to test the profile against. You must 
be root to execute pfinstall with the -D option. 


Using Optional Custom JumpStart Features 


105 







-d disk_config 
-c path 


profile 


Tells pf install to use a disk configuration file, 
diskjconfig , to test the profile against. 

Is the path to the Solaris CD. This is required if the 
Solaris CD is not mounted on /cdrom. (For 
example, use this option if you copied the Solaris 
CD image to disk or mounted the Solaris CD on a 
directory other than /cdrom). 

The name of the profile to test. 


Note - You should run pf install on a system running the same version of 
Solaris software that will be installed by the profile. Otherwise, use 
pf install on the Solaris CD that will be installed by the profile, which is 
located in the /export/ exec /arch . Solaris_2 . 4/sbin/install . d 
directory. 


Run p fins tall from the directory where the profile and diskjconfig files 
reside (which should be the JumpStart directory). If the profile or diskjconfig 
file is not in the directory where pfinstall is run, you must specify the 
path. 

4. Check to see if the results of pf install are as you expected. If not, 
change the profile and go to Step 3. 

-p as ^ ^ You have completed testing the profile. To perform a custom JumpStart 

Complete installation on a system, see Chapter 9, "Booting and Installing Solaris: Custom 
J JumpStart." 


pf install Examples 

Below are some examples of using pf install to test the basic_prof profile 
against the 104_test disk configuration file: 

/usr/sbin/install . d/pf install -D basic_prof 

/usr/sbin/install . d/pf install -d 104_test basic_prof 

/usr/sbin/install . d/pf install -D -c /export/install basic_prof 
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T How to Create a Disk Configuration File for a SPARC System 

A disk configuration file is a file that represents a structure of a disk (for 
example, bytes /sector, flags, slices). Disk configuration files enable you to use 
pfinstall from a single system to test profiles on different sized disks. 

Overview - The procedure to create a disk configuration file for a SPARC 
system involves: 

• Locating a SPARC system with a disk that you want to test a profile against 

• Using the prtvtoc ( 1M) command to create the disk configuration file 
Follow this procedure to create a disk configuration file. 

1. Locate a system with a disk that you want to test a profile against. 

2. Determine the device name for the system's disk. 

3. Redirect the output of prtvtoc to create the disk configuration file: 

$ prtvtoc /dev/rdsk / device jname > disk_config 
In this command. 


/dev/rdsk / device jname Is the device name of the system's disk. 

device_name must be in the form cwtxdys2 or 
cxdys2. 

Note: Slice 2 must be specified in device jname. 
disk_config Is the disk configuration file name. 


4. Copy the disk configuration file to the JumpStart directory: 


/ \ 

Task 

Complete 

v ■ / 


$ cp disk_config jumpstartjiirjpath 


You have completed creating a disk configuration file. The following page 
provides an example of creating a disk configuration file. 
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The following example creates a disk configuration file, 104_test, on a 
system with a 104-Mbyte disk, whose device name is c0t3d0s2. 




In this example, the 104__test file contains the following information: 
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▼ How to Create a Multiple Disk Configuration File for a SPARC System 

If you need to test a profile on multiple disks, you can concatenate disk 
configuration files together to create multiple disk configuration scenarios. 

Overview - The procedure to create a multiple disk configuration file for a 
SPARC system involves: 

• Concatenating two or more disk configuration files into one file 

• Changing the target numbers of the disks (if needed) 

The following procedure creates a disk configuration file to test a profile on 
two 104-Mbyte disks: 

1. Concatenate the 104_test file with itself and save the output to another 
file: 

$ cat 104_test 104_test > dual_104_test 

2. Make sure that each disk device name is specified with a different target. 
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For example, the dual_104_test file is shown as follows: 



# 

cat dual_104_test 




© 

* 

* 

/dev/rdsk/c0t3d0s2 partition map 





* 

Dimensions : 





* 

512 bytes/sector 





* 

35 sectors/track 





* 

6 tracks/cylinder 





* 

210 sectors/cylinder 





* 

1019 cylinders 





* 

* 

974 accessible cylinders 





* 

Flags : 





* 

1 : unmount able 





* 

* 

10: read-only 





* 

First 

Sector 

Last 



* 

Partition Tag Flags Sector 

Count 

Sector Mount 

Directory 



0 2 00 0 

16170 

16169 




1 3 00 16170 

28140 

44309 




2 5 00 0 

204540 

204539 


0 


6 4 01 44310 

160230 

204539 


* 

* 

/dev/rdsk/c0t0d0s2 partition map 





★ 

Dimensions : 





* 

512 bytes/sector 





* 

35 sectors/track 





* 

6 tracks/cylinder 





* 

210 sectors/cylinder 





* 

1019 cylinders 





* 

* 

974 accessible cylinders 





* 

Flags : 





* 

1 : unmount able 





* 

* 

10: read-only 





* 

First 

Sector 

Last 



* 

Partition Tag Flags Sector 

Count 

Sector Mount 

Directory 



0 2 00 0 

16170 

16169 




1 3 00 16170 

28140 

44309 




2 5 00 0 

204540 

204539 




6 4 01 44310 

160230 

204539 
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This is what was done to the dual_104_test file: 

© The first disk device name was not changed. 

© The second disk device name was changed from /dev/rdsk/c0t3d0s2 
to /dev/rdsk/c0t0d0s2. This gives each disk a different target. 


/ \ 

Task 

Complete 

v / 


You have completed creating a multiple disk configuration file. 


Using a Site- Specific Installation Program 

Through the use of begin and finish scripts, sites with special requirements can 
install the Solaris software by creating their own installation program. When a 
minus sign (-) is specified in the profile field, the begin and finish scripts 
control how the system is installed, instead of the profile and the Solaris 
installation program. 

For example, if the following rule would match, the x_install .beg begin 
script and the x_install . fin finish script would install the system named 
sherlock (the Solaris installation program would not be used): 

hostname sherlock x_install .beg - x_install . f in 
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Preparing a System for Upgrade 


6 


Overview 


This chapter provides some guidelines for performing an upgrade installation 
and for preserving local modifications before upgrading from a previous 
version of Solaris software. 


Can You Use Upgrade? 

Upgrade and initial are options in the Solaris installation program that 
determine how Solaris software is copied to disk: 

• Upgrade - This option merges the new version of Solaris software with 
existing files on the system's disk. It saves as many local modifications as 
possible. 

• Initial - This option overwrites the system's disk with the new version of 
Solaris software. 


Note - The upgrade option is not available for 4.1.x systems. Because you must 
use the initial installation option, backing up your data is critical. See the 
Solaris 1.x to Solaris 2.x Transition Guide for information. 


To determine if your system supports the upgrade, see the following table. 



Upgrade Option Is Available 

If at least one disk attached to the system has a Solaris 2.1 or later root file system. 

1) To determine if the system has a root file system, type the following command: 

df -a 

Look for a line of output similar to the following: 

Filesystem kbytes used avail capacity Mounted on 

/dev/dsk/c0tld0s048295 15665 27810 36% / 

2) To determine if the system is running Solaris 2.1 or later, type the following 
commands: 

cd /var/sadm/sof tint o 
more INST_RELEASE 


Note - The upgrade option may require deleting software packages if the disk 
is full; this requires knowledge of packages and dependencies. 


Upgrading and Install Patches 

You do not need to back out install patches before performing an upgrade. 

Check Other Software Documentation 

Check the documentation of other software you are running (e.g. Solstice™ 
DiskSuite™, FrameMaker®) before using the upgrade option. There may be 
additional instructions you need to follow to preserve existing configurations. 

If You're Using Custom JumpStart 

Make sure you change the profile keyword from initial to upgrade in your 
profiles. 
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If You Override the Boot File Location 

For Solaris 2.5 and later, the kernel resides in 

/platform/<arc/z>/kernel/unix; not in /kernel /unix. If you override 
the boot file location by explicitly setting it to kernel /unix, you can 
successfully install Solaris software, but you won't be able to boot the system. 

Upgrading Dataless Clients 

Dataless clients do not get automatically upgraded when the OS server is 
upgraded. After upgrading the OS server, you must perform an upgrade on 
dataless clients. 


Important Files For Upgrading 

The following files must be present on standalone systems, servers, and each 
diskless client being upgraded: 

/var /sadm/sof tinf or/INST_RELEASE 
/var/sadm/ ins tall /contents 
/var/sadm/install_data . clustertoc 
/var/sadm/ ins tall_data/CLUSTER 


Backing Up Your System 

Always back up an existing system before using the upgrade option and 
installing a new version of Solaris software. The safest backup to perform is a 
level 0 dump of all the file systems connected to the system being upgraded. If 
you do not have an established backup procedure, see System Administration 
Guide, Volume I. 
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Preserving Local Modifications 

During an upgrade, the Solaris installation program attempts to preserve local 
modifications to the system whenever possible; however, sometimes local 
modifications can make an upgrade fail or perform differently than you would 
expect. Table 6-1 indicates tasks you should perform before upgrading to make 
your upgrade a success. 

Table 6-1 Preserving Local Modifications 


What to Do Before 


Upgrading 

How to 

Why 

Preserve symbolic 
links 

Replace symbolic links that use 
absolute paths with symbolic links 
that use relative paths. 

For example, if /usr/openwin is a 
symbolic link to 

/ export /openwin 

change the symbolic link to 

. . /export /openwin 

During an upgrade, the installation program cannot 
reference symbolic links that use absolute paths, because 
the Solaris installation program mounts the root (/) file 
system at /a. For example, a symbolic link to 
/export /openwin would fail, because during an 
upgrade, /export /openwin is really 
/ a / export / openwin. 

When the Solaris installation program cannot reference a 
symbolic link, it will overwrite the symbolic link and 
install the software (the installation program doesn't 
think the software exists). As a result, duplicate software 
will be installed on the system and the upgrade may fail 
because of insufficient disk space. 

Preserve symbolic 
links to automounted 
file systems 

Remove packages (by using 
Software Manager or the pkgrm 
command) that will create files or 
directories currently automounted. 

The automounter is not active during an upgrade, so the 
Solaris installation program installs any package's files or 
directories that are symbolic links to automounted file 
systems. If a symbolic link is overwritten, the upgrade 
may fail because of insufficient disk space. 



(If you cannot remove a package, you can replace the 
symbolic link after the upgrade is completed.) 



Note: The /var/mail and /var/news directories, which 
usually reside on an automounted file system, are not 
affected by an upgrade. 
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Table 6-1 Preserving Local Modifications (Continued) 

What to Do Before 
Upgrading 

How to 

Why 

Prevent unneeded 
file systems from 
being mounted 

Comment out file systems in the 
/ etc /vf stab file that you do not 
want mounted during an upgrade. 

During an upgrade, the Solaris installation program 
attempts to mount all the file systems listed in the 
/etc/vfstab file on the root file system being 
upgraded. If the Solaris installation program cannot 
mount a file system, it reports the failure and exits. 


Preparing a System for Upgrade 
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Booting and Installing Solaris: 

Jump Start 7 55 

This chapter describes how to perform a JumpStart installation. 
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1 Make sure you have a new system with the JumpStart 
software. 


If the New System Is A ... 

Then ... 

SPARCclassic™ 

You can use the JumpStart method of 

SPARCstation™ IPX 

installing the Solaris software 

SPARCstation LX 
SPARCstation 5 . 
SPARCstation 10 

described in this chapter. 

SPARCstation 10 SX 
SPARCstation 20 
SPARCstation™ Voyager™ 


None of above 

You must use the interactive method 
or custom JumpStart method; go back 
to "Choose a method for installing 
Solaris software." on page 11 


If the JumpStart software is installed on a system, the Customer Information 
sheet, which is attached to the outside of the system's packing box, will have 
the following entry. 


PRE-INSTALLED SOFTWARE 


PART NUMBER 

DESCRIPTION 

xxxxxxx-xx 

CODE, P/I JUMPSTART 1.1 S4M 


and the "JumpStart for SPARC Systems" document will be included with the 
system's hardware documentation. 
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2 Make sure you have reviewed the task map for a 
JumpStart installation (shown in Figure 2-2 on page 13). 

3 Make sure the Solaris software that will automatically be 
installed meets your needs. 


If the System is A ... 

And the Size of 
Its Formatted, 
Internal Disk is 
Between ... 

Then the Following Solaris Software is 
Installed ... 

SPARCstation Voyager 

200 - 9999 Mbytes 

Core software group, including the 
following SUNW packages: audio, bnur, 
bnuu, lpr, lpu, tltk, xilrt, xildg, xiler, 
xilow, libms, owrqd, admfw, inst, 
admap, loc, doc, apppr, apppu, pppk 

SPARCstation 10 SX 
SPARCstation 20 

320 - 430 Mbytes 

Developer software group and the 
SUNWCsx cluster 

SPARCstation 10 SX 
SPARCstation 20 

431 - 9999 Mbytes 

Entire distribution software group 

SPARCstation 5 

N/A 

End user software group and the 
SUNWCtcx cluster 

SPARCclassic 
SPARCstation IPX 
SPARCstation LX 
SPARCstation 10 

98 - 108 Mbytes 

Core software group, including the 
following SUNW packages: admr, 
admap, admfw, bcp, esu, inst, ipc, lpr, 
lpu, too 

SPARCclassic 
SPARCstation IPX 
SPARCstation LX 
SPARCstation 10 

109 - 9999 Mbytes 

End user software group 


Booting and Installing Solaris: JumpStart 
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4 If you are using the system’s local CD-ROM drive to install 
the Solaris software, prepare the CD-ROM drive. 

The following instructions cover the most common types of CD-ROM drives. If 
your CD-ROM drive is not one of the following types, see your hardware 
manual for instructions. 


CD-ROM Drive - Caddy Version CD-ROM Drive - Tray Version 


© To open the caddy, pinch the 
corners while lifting the lid at 
the center lip. 



© Insert the Solaris CD (logo up) 
and close the caddy. 



© With the arrow on the caddy 
pointing toward the CD-ROM 
drive, insert the caddy. 



© Press the eject button on the 
front panel of the CD-ROM drive 
(a tray will emerge if you have 
this type of caddy). 



© Insert the Solaris CD (logo up) 
into the tray. 

© Push the tray back into CD-ROM 
drive. 
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5 Turn on the components in the order recommended in 
your hardware guide. 

If System Begins to Boot ... If System Displays the > or ok Prompt ... 

You will see messages displayed on Your system does not have the JumpStart 

the screen indicating hardware and software. Go back to page 11 and choose 

system components are being checked, another method of installing Solaris 
The booting phase can last for several software, 
minutes. 

Note: During the booting phase. 

Open Windows is started for 
localization reasons, or for the 
graphical user interface; however, 

OpenWindows is not fully installed 
until Solaris software is installed. 

6 If prompted, provide information about the system. 

After the booting phase, the Solaris installation program may be displayed on 
the screen, prompting you to provide information about the system. 

7 Wait as the Solaris installation program automatically 
installs the Solaris software on the system. 

You're done for awhile; installing the Solaris software can take between 15 
minutes and 2 hours. After a successful installation, the system will reboot and 
you're ready for Step 8. 

8 Start the OpenWindows software to display the desktop: 



For post-installation information, see Chapter 11, "Where to Go After Installing 
Solaris." 



Booting and Installing Solaris: JumpStart 
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Booting and Installing Solaris: 
Interactive 


8 


This chapter provides procedures to boot a system and perform an interactive 
installation using the Solaris installation program. If you're using the: 

• Initial installation option - you can choose the defaults shown and have 
software automatically laid out for you, or you can customize the software 
and file system layout. 

• Upgrade option - you choose the disk for upgrading, add or delete software 
if desired, then start the upgrade. 

The procedure in this chapter should be done on the system that is being 
installed. 
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1 If you are using the system’s local CD-ROM drive to install 
the Solaris software on the system, prepare the CD-ROM 
drive. 

The following instructions cover the most common types of CD drives. If your 
CD drive is not one of the following types, see your hardware manual for 
instructions. 


CD-ROM Drive - Caddy Version CD-ROM Drive - Tray Version 


® To open the caddy, pinch the 
corners while lifting the lid at 
the center. 



© Insert the Solaris CD (logo up) 
and close the caddy. 



© With the arrow on the caddy 
pointing toward the CDROM 
drive, insert the caddy. 



© Press the eject button on the 
front panel of the CD-ROM 
drive (a tray will emerge if 
you have this type of caddy), 



© Insert the Solaris CD (logo 
up) into the tray. 

© Push the tray back into 
CD-ROM drive. 
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2 Make sure you’ve reviewed the task map for an 
interactive installation (Figure 2-3 on page 14). 

3 If you are installing a system connected through a tip line, 
ensure that your window display is at least 80 columns 
wide and 24 rows long. 

Otherwise, the character installation interface will display improperly. You can 
use the stty command to find out the current dimensions of your tip window. 


4 Follow these instructions before you boot the system: 


If The System Is ... 

Then ... 

Off 

1) Turn on the system components in the order 
recommended in the hardware guide. 

Caution: If the system starts booting, press LI -A or 
Stop-A. 

2) Go to Step 5. 

On 

1) If the system is running Solaris, enter the following 
commands: 

$ su root 
# halt 

2) Go to Step 5. 


5 If the screen displays the > prompt instead of the ok 
prompt, then enter n and press Return. 

The screen should now display the ok prompt. 


Booting and Installing Solaris: Interactive 
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Boot the system using the appropriate boot command: 


If You Are Booting ... 

And The System You Are 
Booting Is ... 

Then Enter ... 

From a server on the 
network 

n/a 

boot 

net 

From the system's local 
CD-ROM drive 

SPARCstation 1 (4/60) 
SPARCstation 1+ (4/65) 
SPARCstation SLC™ (4/20) 
SPARCstation IPC™ (4/40) 

boot 

sd( 0,6,2) 


SPARCengine™ IE 

boot 

sd ( 0 , 6 , 5 ) 


All other Sun systems 

boot 

cdrom 


7 Wait for booting to complete. 


After you type the boot command, the system goes through a booting phase 
where hardware and system components are checked. This lasts for several 
minutes. The following screen provides an example of what you should see. 


During the booting phase, 
OpenWindows may be 
started for localization 
reasons, or for the graphical 
user interface; however, 
OpenWindows is not fully 
installed until the Solaris 
software is installed. 



Type b (boot) , c (continue) , or n (new command mode) 

>n 

Type help for more information 

ok boot sd( 0,6,2) 

Booting from: sd ( 0 , 6 , 2 ) 

SunOS Release 5.4 Version [UNIX(R) System V Release] 
Copyright (c) 1983-1994, Sun Microsystems, Inc. 

WARNING: clock gained 35 days -- CHECK AND RESET THE DATE! 
Configuring the /devices directory 
Configuring the /dev directory 
Starting OpenWindows... 


8 Install the Solaris software on the system by using the 
Solaris installation program displayed on the screen. 

You are now in the hands of the Solaris installation program. This menu- 
driven, interactive program guides you step-by-step through installing Solaris 
software; it also has online help to answer your questions. As shown below, the 
program has two interfaces to accommodate different hardware. 
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If you want to record your responses, use the work sheet in Appendix A, 
"Worksheets for the Solaris Installation Program." There is also a time zone 
map on page 178 to help you set your system's time clock. 


If Your System Has A ... 


Then the Interface Is ... 


And the Navigation Device Is ... 


Graphics monitor 


Graphics-based 


The Solaris Installation Program 


You are now interacting with the Solaris 
installation program. The program is divided 
into a series of short sections. At the end of 
each section, you will see a summary of the 
choices you’ve made, and be given the 
opportunity to make changes. 


Exit Help 


Continue 


Mouse 



Non-graphics monitor, 
or an unsupported 
graphics card 


Character-based 


The Solaris Installation Program 

You are now interacting with the Solaris 
installation program. The program is di- 
vided into a series of short sections. At 
the end of each section, you will see a 
summary of the choices you've made, and 
be given the opportunity- to make changes. 


F2_Continue F5_Help 


Keyboard 



9 If you used the upgrade option, see Chapter 10, 
“Completing an Upgrade,” for information needed to 
complete an upgrade. 

You must reboot the system after an upgrade. 


Booting and Installing Solaris: Interactive 
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10 Start the OpenWindows software to display the desktop: 





1 1 If you‘ve allocated space for diskless clients, dataless 
clients, or AutoClient systems during the Solaris installation 
program, you must use the Solstice Host Manager to 
complete set up of these clients. 

The Solaris installation program only allocates space for clients during an 
initial installation. The Solstice Host Manager completes client set up by 
providing their required directories. See the System Administration Guide , 
Volume I. 


For post-installation information, see Chapter 11, "Where to Go After Installing 
Solaris." 
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Booting and Installing Solaris: 

Custom JumpStart 9 = 


This chapter provides a procedure to boot a system and perform a custom 
JumpStart installation using profiles you've created to install Solaris software. 
If you're using the: 

• Initial installation option - Solaris software is automatically installed on 
the system after you boot the system (or turn on the system in some cases). 

• Upgrade option - the system is automatically upgraded to new version of 
Solaris software after you boot the system. 

The procedure in this chapter should be done on the system that is being 
installed. 
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1 If you are using the system’s local CD-ROM drive to install 
the Solaris software on the system, prepare the CD-ROM 
drive. 

The following instructions cover the most common types of CD drives. If your 
CD drive is not one of the following types, see your hardware manual for 
instructions. 


CD-ROM Drive - Caddy Version CD-ROM Drive - Tray Version 


© To open the caddy, pinch the 
corners while lifting the lid at 
the center lip. 



© Insert the Solaris CD (logo up) 
and close the caddy. 



© With the arrow on the caddy 
pointing toward the CD-ROM 
drive, insert the caddy. 



© Press the eject button on the 
front panel of the CD-ROM drive 
(a tray will emerge if you have 
this type of caddy). 



© Insert the Solaris CD (logo up) 
into the tray. 

© Push the tray back into CD-ROM 
drive. 
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2 Make sure you reviewed the task map for a custom 
JumpStart installation (shown in Figure 2-4 on page 15). 

3 If you are using a diskette to perform a custom JumpStart 
installation, insert a diskette that contains a JumpStart 
directory into the system’s diskette drive. 

4 Follow the instructions before you boot the system: 

If the system has the JumpStart software installed (on new or re-preinstalled 
systems), turn on the system and go to Step 7. 


If The System Is ... 

Then ... 

Off 

1) Turn on the system components in the order 
recommended in the hardware guide. 

Caution: If the system starts booting, press Ll-A or 
Stop-A. 

2) Go to Step 5. 

On 

1) If the system is running Solaris, enter the following 
commands: 

$ su root 
# halt 

2) Go to Step 5. 


5 If the screen displays the > prompt instead of the ok 
prompt, then enter n and press Return. 

The screen should now display the ok prompt. 


Booting and Installing Solaris : Custom JumpStart 
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6 Boot the system using the appropriate boot command: 


9 


If You Are Booting ... 

And the System You Are 
Booting Is ... 

Then Enter ... 1 

From a server on the 
network 

n/a 

boot 

net install 

From the system's 
local CD-ROM drive 

SPARCstation 1 (4/60) 
SPARCstation 1+ (4/65) 
SPARCstation SLC (4/20) 
SPARCstation IPC (4/40) 

boot 

sd ( 0 , 6 , 2 ) - ^install 


SPARCengine IE 

boot 

sd ( 0 , 6 , 5 ) - ^install 


All other Sun systems 

boot 

cdrom - ^install 


A space is required between the minus sign and install. 
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7 Wait for booting to be completed. 


After you type the boot command, the system will go through a booting phase 
where various hardware and system components are checked. The following 
screen provides an example of what you should see: 


Type b (boot) , c (continue) , or n (new command mode) 

>n 

Type help for more information 
ok boot net - install 

Booting from: le (0,0,0) - install 
2bc00 hostname: sherlock 
doma i nname : eng 1 and . c om 
root server: london 
root directory: 

/cdrom/solaris_2_5_sparc/s0/export/exec/kvm/sparc . sun4c . Solaris_2 . 4 
SunOS Release 5.5 Version [UNIX(R) System V Release] 

Copyright (c) 1983-1994, Sun Microsystems, Inc. 

Configuring the /devices directory 
Configuring the /dev directory 

Searching for JumpStart directory. . .using london: /jumps tart 
Starting OpenWindows . . . 


Note - The booting phase will last for a few minutes. 


8 If prompted, provide information about the system. 

After the booting phase, the Solaris installation program may be displayed on 
the screen, prompting you to provide information about the system. 

9 Wait as the Solaris installation program automatically 
installs the Solaris software on the system. 

You're done for awhile; installing Solaris software can take between 15 minutes 
and 2 hours. 


Booting and Installing Solaris: Custom JumpStart 


13 5 




10 Start the OpenWindows software to display the desktop: 



$ /usr/openwin/bin/openwin 


1 1 If you used the upgrade option, see Chapter 10, 
“Completing an Upgrade,” for information needed to 
complete an upgrade. 

You must reboot the system after an upgrade. 


12 If you installed Solaris on a server and allocated space for 
diskless clients, dataless clients, or AutoClient systems, 
and you selected the initial installation option, you must 
use the Solstice Host Manager to complete set up of these 
clients. 

The Solaris installation program only allocates space for clients during an 
initial installation. The Solstice Host Manager completes client set up by 
providing their required directories. See the System Administration Guide , 
Volume I. 

For post-installation information, see Chapter 11, "Where to Go After Installing 
Solaris." 


Task 

Complete 

v J 
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Completing an Upgrade 



Overview 


This chapter describes files to check and steps for completing an upgrade. 


What Happened During the Upgrade 

A record of what the installation program did during an upgrade can be 
important to determine if the upgrade was a success. The output of the 
upgrade is saved in the following files: 

• If upgrade fails - /a/var/sadm/system/logs/upgrade_log 

• If upgrade completes and system reboots - 

/var/sadm/ system/ logs /upgrade_log 


Cleaning Up the System After an Upgrade 

During an upgrade, the Solaris installation program merges local software 
modifications of the existing system with the new software; however, in some 
cases, it is not possible. The following file provides a list of the unpreserved 
local modifications during the upgrade that may need to be fixed: 

• If upgrade fails — /a/var/sadm/system/data/upgrade_cleanup 

• If upgrade completes and system reboots - 

/ var / sadm/ system/ da ta/upgrade_c 1 eanup 
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Table 10-1 provides the entry descriptions of the unpreserved local 
modifications that may be found in the upgrade cleanup file. 


Table 10-1 Entry Descriptions of the upgrade_cleanup File 


Entry 

Explanation 

Recommended Action 

filel : existing file renamed to file! 

filel was on the system at the time 
of the upgrade. It had been 
modified since its original 
installation, so upgrade renamed 
filel to file2 and saved the new file 
as filel . 

Determine whether the 
modifications made to file2 
should be made to the new 
version of the file, filel . 

filel : existing file preserved, the new version was 
installed asfile2 

filel has been preserved, and 
upgrade installed the new version 
of the file as file2. 

Determine whether the 
differences in the new 
version oifile2 should be 
incorporated into the 
preserved version of filel . 

file: had been deleted and has now been restored 

file had been deleted from the 
system since its original 
installation, and the upgrade 
installed the new version of file. 

Determine whether file 
should be deleted. 

file: file type was changed from typel to type 2 

file has changed types since its 
original installation, from typel to 
type2. For example, you may have 
changed an actual file to be a 
symbolic link. The upgrade 
changed file back to its original 
type, typel. 

Determine whether file * 
should be changed back to 
type2. 

file: target of symbolic link was changed from targetl 
to target2 

Since the original installation, file 
was changed to be a symbolic link 
to target2 instead of targetl. The 
upgrade changed file to point to its 
original targetl. 

Determine whether file 
should be changed to point 
to target2. 

filel : target of hard link was changed from file2 

When originally installed, filel was 
a hard link to file2. At the time of 
the upgrade, filel was no longer a 
hard link to file2 . Upgrade restores 
the original hard link. 

Determine whether filel 
should be changed to what 
it was before the upgrade. 
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How to Upgrade Clients With Different Platforms and Platform Groups 

If you've upgraded a heterogeneous OS server, clients of that server are 
automatically upgraded only if their platform (SPARC, x86) and platform 
group (for example, sun4d, sun4L, i386) is supported by the Solaris CD. For 
example, if you upgrade a SPARC server using the SPARC Solaris CD, only 
SPARC clients that share the platform group on the CD are upgraded. 

To upgrade clients with different platforms and platform groups, you must use 
the server_upgrade command. See the server_upgrade man page or x86: 
Solaris 2.5 Installation Notes or the SPARC: Installing Solaris Software for more 
instructions. 


Completing an Upgrade 
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Where to Go After Installing Solaris 11 = 


Table 11-1 shows the Solaris documentation that you may need after installing 
the Solaris software on a system. For a complete description of all the Solaris 
2.5 documentation, refer to the Solaris 2.5 Introduction. 


Note - Some SPARC systems require that you add additional software before 
Solaris software is completely installed. Check your hardware vendor 
documentation to see if your vendor requires any additional software to run 
Solaris. For instructions on adding software, see the Solstice AdminSuite 2.1 
User's Guide. 


Table 11-1 Where to Go After Installing Solaris Software 

Information Needed 

Manual Title 

Adding and removing 
Solaris, third-party, or 
unbundled software 

Solstice AdminSuite 2.1 User's Guide 

Setting up mail accounts 

Mail Administration Guide 
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Table 11-1 Where to Go After Installing Solaris Software (Continued) 


Information Needed 

Manual Title 

Installing software (for 
example AnswerBooks) 

System Administration Guide, Volume I 

Note: The End User AnswerBook is the only 
AnswerBook installed with the Solaris software; and 
only installed if the entire distribution software group 
is installed. 

Setting up user accounts 

System Administration Guide, Volume I 

Halting a system 

System Administration Guide, Volume I 

Boot files 

System Administration Guide, Volume I 

Adding systems to a 
network 

System Administration Guide, Volume I 

Accessing remote files and 
systems 

System Administration Guide, Volume I 

Administering file systems 

System Administration Guide, Volume I 

Setting up system security 

System Administration Guide, Volume I 

CD-ROM and diskette 
drives 

System Administration Guide, Volume I 

Setting up printers 

System Administration Guide, Volume II 

Increasing your system's 
performance 

System Administration Guide, Volume II 

Managing disk use 

System Administration Guide, Volume II 

Examining and changing 
system information 

System Administration Guide, Volume II 

Using crontabs 

System Administration Guide, Volume II 
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Table 11-1 Where to Go After Installing Solaris Software (Continued) 


Information Needed 

Manual Title 

Adding and Maintaining 
Peripherals 

System Administration Guide, Volume II 

Accessing devices 

System Administration Guide, Volume II 

Setting up disks 

System Administration Guide, Volume 11 

Terminals and modems, 
disk drives, tape drives, 
service access facility, 
connecting devices to serial 
port, format utility 

System Administration Guide, Volume II 

Using system 
administration tools 

Solstice AdminSuite 2.1 User's Guide 


Where to Go After Installing Solaris 
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Worksheets for the Solaris 

Installation Program A 55 


What's in the Worksheets 

The worksheets list information that may need to be supplied during the 
Solaris installation program. There are separate worksheets for the initial and 
upgrade options. 


How to Use the Worksheets 

The worksheets can be used before installing Solaris software, or to record 
your responses when you install Solaris software. For example, if you're a 
system administrator of a large site and need to delegate the task of installing 
Solaris software to less-experienced staff, you can fill out the worksheet in 
advance; installers will know exactly how you want them to install Solaris 
software on their system, thus reducing the errors that come from guessing. 


What shaded areas mean Note - If you're using the following worksheet to gather information before 

in the following table installing Solaris software, you can ignore shaded areas if you are installing a 

system as a standalone, non-networked system. 
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Worksheet for the Initial Installation Option 

The following worksheet lists important information you may need to supply 
when installing Solaris software on a system for the first time. 


Information You May Need 
When Installing Solaris 

Description/Example 

Work Space 

Host name 

Host name of the system. 
Example: sherlock 


Network connectivity 

Is the system connected to a 
network? 


ISIllI 

Primary network interface for the 
system. 

Example: leO 


. •• 

Internet protocol address of the 
system you're installing. 
Example: 129.221.2.1 



Is the system a client of NIS+ or 
NIS? Part of another name 
service? Or is a name service not 
yet established? 

Example: Other, DCE 


Domain name 

Domain in which the system 
resides. 

Example:chandy. West. Arp. COM 


Name server 

Specify a name server for the 
system, or have software try to 
find one? 
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Information You May Need 
When Installing Solaris 

Description/Example 

Work Space 

Name server information 

Name server's host name and IP 
address. 

Example: toucan, 125.221.2.1 


Subnet 

Is the system part of a subnet? 


Netmask 

Netmask of the subnet. 
Example: 255.255.0.0 


Time zone 

Default time zone. Can be set by 
selecting geographic region, hours 
offset from GMT, or by pointing to 
a file in /usr/share/zoneinf o 
directory. 

Example: US /Mountain 


System type 

System type: standalone system, 
OS server, or dataless client? 


■ 

f® mm 

All the platforms for clients that 
are different from the OS server's 
platform (see Appendix C, 
"Platform Names and Groups"). 


Allocate client services 

Number of clients the OS server 
will support. 

Example: 5 (default) 



Number of megabytes of swap, 
root, or both to assign clients. 
Example: 24 Mbytes (default) 



Worksheets for the Solaris Installation Program 
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Information You May Need 
When Installing Solaris 

Description/Example 

Work Space 

Dataless clients 

Note: SunSoft plans to remove 
support for the dataless client 
system type after Solaris 2.5. You 
can select this system type now, 
but in future releases you will 
need to select a different type. 



Host names and IP addresses of 
the server(s) where dataless clients 
will mount their /usr file 
systems. 

Example: morton, 112.221.2.1, 

/export /home 


Languages 

Language(s) to select for 
displaying the user interface after 
installing Solaris software. 
Example: French, Spanish 
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A 


Information You May Need 

When Installing Solaris Description/Example Work Space 


Software 

Which software group to install? 

• Core 

• End user system support 

• Developer system support 

• Entire distribution 

• Entire distribution plus OEM 
support 


Should the software group be 
customized? 


Note: Removing or adding 
software often creates software 
dependencies; system 
administration knowledge is often 
required to fix dependencies. 

Disk(s) to install Solaris 
software on 

Disk(s) for installing Solaris. 
Example: cOtOdO, c0t3d0, dMdl 

Auto-layout file systems? 

Should file systems be laid out on 
disks automatically or manually? 


Note: Manual layout requires 
advanced system administration 
skills. 

File systems to auto-layout 

Which file systems should be used 
for auto-layout? 

Example: /, /opt, /var 

Preserve existing data? 

Should existing data on disk(s) be 
preserved? 


Worksheets for the Solaris Installation Program 
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Information You May Need 
When Installing Solaris 

Description/Example 

Work Space 

Disk slices to preserve data 

Which slices should be preserved? 
Example: /opt on c0t2d2 


File system and disk layout 

Accept the layout of file systems 
as created by auto-layout or 
manual layout, or customize? 



Note: Customizing requires 
advanced system administration 
skills. 


Mount remote file systems? 

Mount remote file systems from a 
server? 


. .. ^ VV-;^ :V ^ 

Provide remote file system 
information: 

• Local mount point 

• Server's host name 

• Server's IP address 

• File system path 



Example: 

Server: mitra 

Server IP address: 129.222.2.2 
File system path: /export /home 
Local mount point: /export 


Reboot 

Reboot after installing Solaris? 


Root password 

Create root password. 
Example: cat6file 
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Worksheet for the Upgrade Option 

The following worksheet lists the important information you may need to 
supply when upgrading a system from Solaris 2.1 or later. 

Information You May Need 
When Upgrading Solaris 

Description/Example 

Work Space 

Host name 

Host name of the system 
Example: sherlock 


Network connectivity 

Is the system connected to a 
network? 


Primary network interface 

Primary network interface for 
the system. 

Example: leO 


IP address 

Internet protocol address of the 
system you're installing. 
Example: 129.221.2.1 


Name service 

■ i 

Is the system a client of NIS+ or 
NIS? Part of another name 
service? Or is a name service 
not yet established? 

Example: Other, DCE 


Domain name 

Domain in which the system 
resides. 

Example: chandon 
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Information You May Need 
When Upgrading Solaris 

Description/Example 

Work Space 

Name server 

Specify a name server for the 
system, or have software try to 
find one? 


Name server information 

Name server's host name and IP 
address. 

Example: toucan, 125.221.2.1 


Subnet 

Is the system part of a subnet? 


Netmask 

Netmask of the subnet. 
Example: 255.255.0.0 


Time zone 

Default time zone. Can be set by 
selecting geographic region, 
hours offset from GMT, or by 
pointing to a file in 

/usr/ share/ zoneinfo 

directory. 

Example: US /Mountain 


Installing Solaris - upgrade 
or initial? 

Choose the upgrade or initial 
option for installing Solaris. 


Disks to upgrade 

Select a disk to use for 
upgrading to new version of 
Solaris. 

Example: cOdOtO 
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Information You May Need 



When Upgrading Solaris 

Description/Example 

Work Space 

Languages 

Language(s) to select for 
displaying the user interface 
after installing Solaris software. 
Example: French, Spanish 


Customizing software? 

Do you want to customize 
software before starting the 
upgrade? 

Note: Removing or adding 
software often creates software 
dependencies; system 
administration knowledge is 
often required to fix 
dependencies. 
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System Identification Label 


B 


For your convenience, the following pages contain system identification labels 
(a sample, and one for photocopying). Attach them to systems at your site so 
users have access to information needed to install Solaris software and operate 
their system. 
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Sample - System Identification Label 

As shown in the following sample, system identification labels can provide a 
quick reference to important system information. 


Host name: roylat 


Boot command 

boot sd(0,6,2) 

System type 

Standalone system 


□ OS server 


□ Diskless client 


□ Dataless client 


□ AutoClient system 

Platform name 

sun4c 

Terminal type 

SPARCstation IPC 

Networked? 

Yes 

Primary network interface 

leO 

IP address 

129.221.2.1 

Name service 

NIS+ 

Domain name 

hawthorne.East.Arp.COM 

Name server and IP address 

hudson, 125.222.2.2 

System part of a subnet? 

Yes 

Netmask 

225.225.225.225 

Ethernet address 

8:0:20:b:40:e7 
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System Identification Label 

Photocopying the following label and identifying system information for each 
system provides a quick reference for users. 


Host name: 


Boot command 


System type 

□ Standalone system 

□ OS server 

□ Diskless client 

□ Dataless client 

□ AutoClient system 

Platform name 
Terminal type 
Networked? 

Primary network interface 
IP address 
Name service 


Domain name 
Name server 
System part of a subnet? 

Netmask 
Ethernet address 


System Identification Label 


1 57 
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Platform Names and Groups C EE 


Table C-l shows the platform names of various hardware platforms. You may 
need this information when preparing a system to install Solaris software. 

Use uname -i to determine a system's platform name; use uname -m to 
determine a system's platform group. 

Table C-l Platform Names and Groups 

System 

Platform Name 

Platform Group 

x86 

i86pc 

i86pc 

SPARCstation 1 

SUNW,Sun_4_60 

sun4c 

SPARCstationl+ 

SUNW,Sun_4_65 

sun4c 

SPARCstation SLC 

SUN W, Sun_4_20 

sun4c 

SPARCstation ELC 

SUNW,Sun_4_25 

sun4c 

SPARCstation IPC 

SUN W, Sun_4_40 

sun4c 

SPARCstation IPX 

SUN W, Sun_4_50 

sun4c 

SPARCstation 2 

SUN W, Sun_4_7 5 

sun4c 

SPARCcenter 1000 

SUNW,SPARCserver-1000 

sun4d 

SPARCcenter 2000 

SUNW, SPARCcenter-2000 

sun4d 


159 



Table C-l Platform Names and Groups 


System Platform Name 


SPARCstation 5 
SPARCstation 10 
SPARCstation 10SX 
SPARCstation 20 
SPARCserver6xx 
SPARCstation LX 
SPARCstation LX+ 
SPARCclassic 
SPARCclassic X 
SPARCengine EC3 
SPARCstation Voyager 


SUNW,SPARCstation-5 

SUNW,SPARCstation-10 

SUNW,SPARCstation-10,SX 

SUNW,SPARCstation-20 

SUNW,SPARCsystem-600 

SUNW,SPARCstation-LX 

SUNW,SPARCstation-LX+ 

SUNW, SPARCclassic 

SUNW,SPARCclassic-X 

SUNW,SPARCengine-EC-3 

SUNW,S240 


Sun Ultra 1 Model 140 SUNW,Ultral-140 

Other SPARC systems See your hardware vendor 
documentation for platform 
name information. 


Platform Group 

sun4m 

sun4m 

sun4m 

sun4m 

sun4m 

sun4m 

sun4m 

sun4m 

sun4m 

sun4m 

sun4m 

sun4u 


SPARC: Installing Solaris Software — November 1995 



Sample Custom JumpStart 

Installation D= 

This example shows a set of steps a system administrator would take to do a 
custom JumpStart installation for a fictitious site. 

Sample Site Setup 

Figure D-l shows the sample site setup for this example. 



server_1 = install/boot server marketing_server = boot server 


Figure D-l Sample Site Setup 
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At this fictitious site: 

• The engineering group is on its own subnet. This group uses 32-Mbyte Sun 
IPX systems for software development. 

• The marketing group is on its own subnet. This group uses 16-Mbyte Sun 
ELC systems for running word processing, spreadsheets, and other office 
tools. 

• The site uses NIS+. The Ethernet addresses, IP addresses, and host names 
are in NIS+ tables. 

• The engineering server named server_l has a copy of Solaris 2.4 software 
on its local disk in a directory named /export /ins tall. Both the 
engineering and marketing groups will install Solaris software over the 
network from serverJL. 

1 Create a JumpStart directory. 

The administrator sets up a JumpStart directory on the install server, 
server_l. This directory will hold files necessary for a custom JumpStart 
installation of Solaris software. The easiest way to set up this directory is to 
copy the sample directory from the copy of the Solaris CD that has been put in 

/export /ins tall. 

# cp -r /export/install/auto_install_sample /jumpstart 
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2 Share the JumpStart directory. 


D 


The system administrator shares the / jumps tart directory so that the rules 
file and profiles are accessible to systems on the network. To accomplish this, 
the administrator adds the following line to the /etc/df s/df stab file: 


share -F nfs -o ro / anon=0 /jumpstart 


Then, at the command line, the administrator uses the unshareall and 
shareall commands: 


# unshareall 

# shareall 


3 Create the eng_profiie profile. 

The administrator creates a file named eng_prof ile in the / jumpstart 
directory The eng__prof ile file has the following entries, which define the 
Solaris software to be installed on systems in the engineering group. 


o 

install_type 

ini tial_ins tall 

© 

system_type 

standalone 

© 

partitioning 

default 

o 

cluster 

SUNWCprog 

0 

f ilesys 

any 50 swap 


O Specifies that the installation will be treated as an initial installation, as 
opposed to an upgrade. 

© Specifies that the engineering systems are standalone systems. 

© Specifies that the JumpStart software uses default disk partitioning for 
installing Solaris software on the engineering systems. 

O Specifies that the developer's software cluster will be installed. 

© Specifies that each system in the engineering group will have 50 Mbytes of 
swap space. 
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4 Create the marketing_profile profile. 


The administrator creates a file named marketing_prof ile in the 
/jumpstart directory. The marketing_prof ile file has the following 
entries, which define the Solaris software to be installed on systems in the 
marketing group. 


o 

install_type 

ini tial_ins tall 

© 

system_type 

standalone 

© 

partitioning 

default 

© 

cluster 

SUNWCuser 

© 

package 

SUNWaudmo 


O Specifies that the installation will be treated as an initial installation, as 
opposed to an upgrade. 

© Specifies that the marketing systems are standalone systems. 

© Specifies that the JumpStart software will use default disk partitioning for 
installing Solaris software on the marketing systems. 

© Specifies that the end user software cluster is to be installed. 

© Specifies that the audio demo software package is to be added to each 
system. 

5 Edit the rules file. 

The administrator must define the rules file. The Solaris installation program 
will use the contents of this file to select the proper installation for each 
department. 

At this site, each department is on its own subnet and network address. The 
administrator uses this information to control how systems are installed. The 
engineering department is on subnet 255.222.43.0, and marketing is on 
255.222.44.0. 

In the / jumpstart directory, the administrator edits the rules file, deletes all 
of the example rules, and enters: 


network 255.222.43.0 - eng_profile 
network 255.222.44.0 - marketing_prof ile - 
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Note - These are sample rules in which an administrator uses a network 
address to identify which systems will be installed with the eng_prof ile and 
marketing_prof ile, respectively. The administrator could also have chosen 
to use host names, memory size, or model type as the rule keyword. See "Rule 
Keyword and Rule Value Descriptions" on page 88 for a complete list of 
keywords you can use in a rules file. 


6 Execute the check script. 


After the rules and profile files are properly set up, the system administrator 
runs the check script to verify the files. 



When check finds no errors, it creates the rules . ok file. 
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7 Set up the engineering systems for installation. 


D 


After setting up the / jumps tart directory and appropriate files, the 
administrator sets up the install server to install Solaris software on the 
engineering systems. 

The administrator first sets up the engineering systems because they are on the 
same subnet as the install server. On the install server, the administrator uses 

the add_install_client command: 


# cd /export/install 

# . /add_install_client -c server_l : /jumps tart host_engl sun4c 

# . /add_install_client -c server_l : /jumps tart host_eng2 sun4c 


In the add_install_client command. 


host_engl 

host_eng2 


sun4c 


Specifies the server (server_l) and path 
(/jumps tart) to the JumpStart directory. 

Is the name of a system in the engineering group. 

Is the name of another system in the engineering 
group. 

Specifies the platform of the systems that will use 
server_l as an install server. (This is the proper 
platform name for Sun IPX systems.) 
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8 Set up the marketing systems for installation. 


Systems cannot boot from an install server on a different subnet, so the 
administrator sets up a boot server on the marketing group's subnet. On a 
server on the marketing subnet, the administrator inserts a Solaris CD. The 
administrator then uses the setup_install_server command to copy the 
boot software from the CD to the marketing server. 


# cd /cdrom/cdromO/sO 

# . /setup__install_server -b /marketing/boot-dir sun4c 


In the setup_install_server command, 

-b Specifies that setup_install_server will copy 

the boot information from the Solaris CD to the 
directory named /marketing/boot-dir. 

sun4c Specifies the platform of the systems that will use 

this boot server. (This is the proper platform name 
for Sun ELC systems.) 


Next, the administrator sets up the marketing systems to boot from the local 
boot server and install Solaris from the remote install server. The administrator 
uses the add_install_client command on the marketing group's boot 
server: 


# cd /marketing/boot-dir 

# . /add_install_client -s server_l : /export/install -c server__l : / jumpstart host_mktl sun4c 

# . /add_install_client -s server_l : /export/install -c server_l : /jumpstart host_mkt2 sun4c 


In the add_install_client command, 

-s Specifies the install server (server_l) and the 

path to the Solaris software (/export /ins tall). 
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D 


host_mktl 

host__mkt2 


sun4c 


Specifies the server (server__l) and path 
(/ jumpstart) to the JumpStart directory. 

Is the name of a system in the marketing group. 

Is the name of another system in the marketing 
group. 

Specifies the platform of the systems that will use 
this boot server. (This is the proper platform name 
for Sun ELC systems.) 


9 Boot the systems and install Solaris software. 

The administrator boots the engineering systems by using the following boot 
command at the ok (PROM) prompt of each system. 


ok boot net - install 
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Troubleshooting 


E 


This appendix describes problems you may encounter when installing Solaris 
software, and suggests possible solutions. 

The following table shows common error messages and the page number 
where you can find causes and possible solutions. 


boot: cannot open fkernel/unix 

page 171 

\ Error: Unknown client "host_name" 

page 170 

leO: No carrier - transceiver cable problem 

page 1 70 

No network boot server. Unable to install the system. See installation 
\ instructions. 

page 170 

pkgrm: ERROR: class action script did not complete successfully. Removal 
of <S UNWuodte> failed. 

page 171 

promjpanic: Could not mount filesystem 

page 171 

The file just loaded does not appear to be executable 

page 171 

\ Timeout waiting for ARP/RARP packet... 

page 1 72 

WARNING: clock gained xxx days - CHECK AND RESET DATE! 

page 172 

WARNING: getfile: RPC failed: error 5 (RPC Timed out). 

page 173 






Specific Installation Errors 

Error: Unknown client " host_ 

name " 

Reason Error Occurred 

How to Fix the Problem 

The host_name argument in the 
add__install_client command must 
be a host in the name service. 

Add the host hostjname to the NIS or NIS+ name service. (Either update the 
NIS maps or populate the NIS+ tables.) Try executing the 

add_install_client command again. 

leO: No carrier - transceiver cable problem 

Reason Error Occurred 

How to Fix the Problem 

This system is not connected to the 
network. 

If this is a non-networked system, ignore this message. If this is a networked 
system, make sure the Ethernet cabling is attached securely. 

No network boot server. Unable to install the system. 
See installation instructions. 

Reason Error Occurred 

How to Fix the Problem 

This error occurs on a system that you 
are attempting to install using custom 
JumpStart. The system could not find a 
local Solaris CD or an install server on 
the network. 

The system administrator must set up an install server to be used for custom 
JumpStart installation (see Creating an Install Server on page 22). Otherwise, 
you must do an interactive installation, as documented in Chapter 8, 
"Booting and Installing Solaris: Interactive." 
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pkgrm: ERROR: class action 

<SUNWuodte> failed. 

script did not complete successfully . Removal 

of 

Reason Error Occurred 

How to Fix the Problem 


Problem in Solaris 2.4 and early 2.5 with 
building the package. 

Ignore the message. 


prom_panic: Could not mount 

filesystem 


Reason Error Occurred 

How to Fix the Problem 


This error occurs when you are doing a 
network installation, but the boot 
software cannot locate the Solaris 
installation image (either the Solaris CD 
or a copy of the Solaris CD on the install 
server). 

Make sure that the installation software is mounted and shared. 

If installing from the install server's CD-ROM drive, make sure the Solaris 
CD is inserted in the CD-ROM drive, is mounted, and shared in the 
/etc/dfs/dfstab file. If installing from a copy of the Solaris CD on the 
install server's disk, make sure the directory path to the copy is shared in 
the /etc/dfs/dfstab file. 

boot: cannot open /kernel /unix 

Reason Error Occurred 

How to Fix the Problem 


This error occurs when you override the 
boot file location by explicitly setting it to 
/kernel /unix. In Solaris 2.5, the kernel 
no longer resides in /kernel /unix, but 
in /platf orm/<arc/i>/kernel/unix. 

Reset the boot file in the PROM to " " (nothing). 


The file just loaded does not appear to be executable 
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Reason Error Occurred 

How to Fix the Problem 

This message cannot find the proper 
media for booting. 

Verify that you are using the correct boot command for your system. If 
installing from a CD-ROM drive, make sure the Solaris CD is in the 
CD-ROM drive and that the CD-ROM drive is mounted. See the table for 
boot commands on page 128. 

Timeout waiting for ARP/RARP packet... 

Reason Error Occurred 

How to Fix the Problem 

The client is trying to boot over the 
network, but it cannot find a system that 
knows about it. 

Verify the system's host name is in the NIS or NIS+ name service. Also, 
verify the bootparams search order in the /etc/nsswitch. conf file. For 
example, the following line in the /etc/nsswitch . conf file indicates the 
software will first look in the NIS maps for bootparams information. If not 
found there, software will look in the /etc /bootparams file. 


bootparams: nis files 

WARNING: clock gained XXX days -- CHECK AND RESET DATE! 


Reason Error Occurred How to Fix the Problem 

This is an informational message. Ignore the message and continue with the installation. 
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WARNING: getfile: RPC failed: error 5 (RPC Timed out). 


Reason Error Occurred 

This error occurs when you have two or 
more servers on a network responding to 
an install client's boot request. The install 
client connects to the wrong boot server, 
and the installation hangs. The following 
specific problems may cause this error: 

• There may be /etc/bootparams files 
on different servers with an entry for 
this install client. 

• There may be multiple /tf tpboot or 
/rplpboot directory entries for this 
install client. 

• There may be an install client entry in 
the /etc/bootparams file on a server 
and an entry in another 
/etc/bootparams file enabling all 
systems to access the profile server. 
Such an entry would look like this: 

• install_confi g ^profile _server : path 

A line like this in the NIS or NIS+ 
bootparams table would also cause this 
error. 


How to Fix the Problem 

Examine the network setup: 

• Ensure that servers on the network do not have multiple 
/etc/bootparams entries for the install client. If they do, remove 
duplicate client entries in the /etc/bootparams file on all install and 
boot servers except the one you want the install client to use. 

• Ensure that servers on the network do not have multiple / tf tpboot or 
/rplboot directory entries for the install client. If they do, remove 
duplicate client entries from the / tf tpboot or /rplboot directories on 
all install and boot servers except the one you want the install client to use. 

• If there's a wildcard entry in the name service bootparams map or table 
(for example, * install_conf ig=), delete it and add it to the 
/etc/bootparams file on the boot server. 
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General Installation Problems 


Problem How to Fix the Problem 

The system boots over the network, but On the name server, update the /etc/bootparams entry for the system 
from a system other than the specified being installed. The entry should conform to the following syntax: 
install server. 

install, ^system root =boot_server : path ins tal 1 =install_server : path 

Also, ensure there is only one bootparams entry on the subnet for the 
install client. 


Problem How to Fix the Problem 

After you set up an install server and Be sure the tf tpd daemon is running on the install server. Type the 
configure the system to install over the following command and press Return: 
network, the system still does not boot. 

ps -ef I grep tftpd 

If this command does not return a line indicating the tftpd daemon is 
running, edit the /etc/inetd. conf file and remove the comment (#) 
character from the following line: 

#tftp dgram udp wait root/usr/sbin/in. tftpd in. tftpd -s 
/ tf tpboot 

After making this change, try booting the system again. 


174 


SPARC: Installing Solaris Software — November 1995 



Problem 


How to Fix the Problem 


OpenWindows is not available to 
diskless and dataless clients. 


The /usr/openwin may be on a separate, mounted file system. This 
directory is not automatically shared by admintool. 

The /usr/openwin file system must be manually added to the server's 
/etc/dfs/dfstab file and the file system must be shared. The entry looks 
like this: 

share -F nfs /usr/openwin 

Also, an explicit mount of the file system must be made in the client's 
/etc/vfstab file using the following: 

server_name : /usr/openwin - /usr/openwin nfs - yes - 
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Problem 


How to Fix the Problem 


Several processes that normally run 
when booting the system are not run 
when the system boots from the 
CD. (This is done to enable the system to 
boot and the Solaris installation program 
to run with only 16 Mbytes of memory.) 


To boot from the CD to do disaster recovery (that is, restoring the root file 
system), you need to add functionality normally provided when booting. To 
provide this functionality, a script is provided, /sbin/setup_cd, which 
can be run to perform the additional setup that might be needed to do 
disaster recovery. setup_cd does the following tasks: 

- Finishes setting up the device file system for tapes and ports 

- Enables routing 

- Enables multicast 

- Invokes the statd ( 1M) daemon 

- Invokes the lockd ( 1M) daemon 

- Starts the automounter 


Note that if setup_cd is run on a 16 Mbyte system, it may not be possible 
to run sun install or other programs that need more memory. If a disk 
with a swap partition is available, the system administrator could avoid this 
problem by using the swap ( 1M) command to add swap space to the system 
before invoking setup_cd. 

When booting from the CD during disaster recovery, it is possible to boot the 
system in single user mode from the CD. For example: 

boot cdrom -s 7 


Problem 


How to Fix the Problem 


An installation using the upgrade option 
fails for reasons beyond your control, 
such as a power failure or a network 
connection failure. The system may be in 
an unbootable state. 


1. Reboot the system from the Solaris CD or from the network. 

2. Choose the upgrade option for installation. 

The Solaris installation program will determine if the system has been 
partially upgraded and will continue the upgrade. 
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Time Zones 



The next page shows time zones of the world by hours offset from Greenwich 
Meantime. This may be useful when setting a system's clock during the Solaris 
installation program. 

Figure F-l reflects Standard Time. If daylight saving time is in effect, add one 
hour. 
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Figure F-l Greenwich Meantime Map 
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Glossary 



AutoClient system 

A system type that caches all of its needed system software from an OS server. 
Because it contains no permanent data, an AutoClient is a field replaceable unit 
(FRU). It requires a small local disk for swapping and for caching its individual 
root (/) and /usr file systems from an OS server. 

begin script 

A user-defined Bourne shell script, specified within the rules file, that 
performs tasks before the Solaris software is installed on the system. Begin 
scripts can be used only with custom JumpStart installations. 

boot server 

A server that provides boot services to systems on the same subnet. A boot 
server is required if the install server is on a different subnet than the systems 
that need to install the Solaris software from it. 


client 

cluster 


A system connected to a network. 

A logical grouping of software packages. The Solaris software is divided into 
four main software groups , which are each composed of clusters and packages. 
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core 


custom JumpStart installation 


dataless client 


derived profile 


developer system support 


disk configuration file 


diskless client 


domain 


A software group that contains the minimum software required to boot and 
run the Solaris operating environment on a system. It includes some 
networking software and the drivers required to run the Open Windows 
environment; it does not include the OpenWindows software. 


A type of installation in which the Solaris software is automatically installed 
on a system based on a user-defined profile. You can create customized profiles 
for different types of users. 


A networked system that has its own disk on which it maintains its own root 
(/) file system and swap space. However, a dataless client relies on an OS 
server for its /usr system. 


A profile that is dynamically created by a begin script during a custom 
JumpStart installation. 


A software group that contains the End User System Support software group 
plus the libraries, include files, man pages, and programming tools for 
developing software. 


A file that represents a structure of a disk (for example, bytes /sector, flags, 
slices). Disk configuration files enable you to use pf install from a single 
system to test profiles on different sized disks. 


A networked system that does not have its own disk, so it relies completely on 
an OS server for software and file storage. Diskless clients do not have to use 
the Solaris installation program, because they use the software that is already 
installed on an OS server. 


A part of the Internet naming hierarchy. It represents a group of systems on a 
local network that share administrative files. 
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domain name 


The identification of a group of systems on a local network. A domain name 
consists of a sequence of component names separated by periods (for example: 
tundra.mpk.ca.us). As you read a domain name from left to right, the 
component names identify more general (and usually remote) areas of 
administrative authority 


end user system support 


entire distribution 


A software group that contains the core software group plus the recommended 
software for an end user, including OpenWindows and DeskSet software. 


A software group that contains the entire Solaris release. 


entire distribution plus OEM support 

A software group that contains the entire Solaris release, plus additional 
hardware support for OEMs. This software group is recommended when 
instaling Solaris software on servers. 


/etc 


/export 


fdisk partition 


file server 


A directory that contains critical system configuration files and maintenance 
commands. 


A file system on an OS server that is shared with other systems on a network. 
For example, the /export file system can contain the root file system and 
swap for diskless clients and the home directories for users on the network. 
Diskless clients rely on the /export file system on an OS server to boot and 
run. 


A logical partition of a disk drive dedicated to a particular operating system on 
x86 systems. During the Solaris installation program, you must set up at least 
one Solaris fdisk partition on an x86 system. x86 systems are designed to 
support up to four different operating systems on each drive; each operating 
system must reside on a unique fdisk partition. 

A server that provides the software and file storage for systems on a network. 
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file system 

A collection of files and directories that, when set into a logical hierarchy, make 
up an organized, structured set of information. File systems can be mounted 
from your local system or a remote system. 

finish script 

A user-defined Bourne shell script, specified within the rules file, that 
performs tasks after the Solaris software is installed on the system, but before 
the system reboots. Finish scripts can be used only with custom JumpStart 
installations. 


host name 

The name by which a system is known to other systems on a network. This 
name must be unique among all the systems within a given domain (usually, 
this means within any single organization). A host name can be any 
combination of letters, numbers, and minus sign (-), but it cannot begin or end 
with a minus sign. 


initial installation option 

An option presented during the Solaris installation program that overwrites 
the disk(s) with the new version of Solaris. The initial installation option is 
presented for upgradable systems; however, the disk(s) that contain the old 
version of Solaris software (including the local modifications) will be 
overwritten if you choose the initial installation option. 

install server 

A server that provides the Solaris installation image for other systems on a 
network to boot and install from (also known as a media server). The Solaris 
installation image can reside on the install server's CD-ROM drive or hard 
disk. 

interactive installation 

A type of installation where you have full hands-on interaction with the Solaris 
installation program to install the Solaris software on a system. 
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IP address 


Internet protocol address. A unique number that identifies a networked system 
so it can communicate via Internet protocols. It consists of four numbers 
separated by periods. Most often, each part of the IP address is a number 
between 0 and 225; however, the first number must be less than 224 and the 
last number cannot be 0. 

IP addresses are logically divided into two parts: the network (similar to a 
telephone area code), and the system on the network (similar to a phone 
number). 


JumpStart directory 

When using a diskette for custom JumpStart installations, the JumpStart 
directory is the root directory on the diskette that contains all the essential 
custom JumpStart files. When using a server for custom JumpStart 
installations, the JumpStart directory is a directory on the server that contains 
all the essential custom JumpStart files. 


JumpStart installation 

A type of installation in which the Solaris software is automatically installed on 
a system by using factory-installed JumpStart software. 


locale 


A specific language associated with a region or territory. 


media server 


See install server. 


mount 


mount point 


name server 


The process of making a remote or local file system accessible by executing the 
mount command. To mount a file system, you need a mount point on the local 
system and the name of the file system to be mounted (for example, /usr). 


A directory on a system where you can mount a file system that exists on the 
local or a remote system. 


A server that provides a name service to systems on a network. 
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name service 

network installation 
networked systems 

NIS 

NIS+ 

non-networked systems 
/opt 

OS server 


A distributed network database that contains key system information about all 
the systems on a network, so the systems can communicate with each other. 
With a name service, the system information can be maintained, managed, and 
accessed on a network-wide basis. Sun supports the following name services: 
NIS (formerly YP) and NIS+. Without a name service, each system has to 
maintain its own copy of the system information (in the local /etc files). 


A way to install software over the network — from a system with a CD-ROM 
drive to a system without a CD-ROM drive. Network installations require a 
name server and an install server . 


A group of systems (called hosts) connected through hardware and software, 
so they can communicate and share information; referred to as a local area 
network (LAN). One or more servers are usually needed when systems are 
networked. 


Network Information Service. A type of name service that is standard on 
SunOS 3.x, 4.x, and Solaris 1.x systems. 


Network Information Service, Plus. The replacement for NIS that provides 
automatic information updating and adds security features such as 
authorization and authentication. NIS+ is the standard on Solaris 2.x systems. 

Systems that are not connected to a network or do not rely on other systems. 


A file system that contains the mount points for third-party and unbundled 
software. 


A system that provides services to systems on a network. To serve diskless 
clients, an OS server must have disk space set aside for each diskless client's 
root file system and swap space (/export/root, /export /swap). To serve 
dataless clients, an OS server must provide the /usr file system. To serve 
autoclients, an OS server must provide everything except the individual root 
(/) and /usr file systems required for swapping and caching. 
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package 

A functional grouping of files and directories that form a software application. 
The Solaris software is divided into four main software groups , which are each 
composed of clusters and packages. 


platform group 

A vendor-defined grouping of hardware platforms for the purpose of 
distributing specific software. Examples of valid platform names are i86pc, 
sun4c. 


platform name 

The output of the uname -i command. For example, the platform name for 
the SPARCstation IPX is SUNW,Sun_4_50. 


profile 


/ (root) 


rule 


rules file 


rules.ok file 


slice 


A text file used as a template by the custom JumpStart installation software. It 
defines how to install the Solaris software on a system (for example, initial 
installation or upgrade option, system type, disk partitioning, software group), 
and it is named in the rules file. See rules file. 


The file system at the top of the hierarchical file tree on a system. The root 
directory contains the directories and files critical for system operation, such as 
the kernel, device drivers, and the programs used to start (boot) a system. 


A series of values that assigns one or more system attributes to a profile. 


A text file used to create the rules . ok file. The rules file is a look-up table 
consisting of one or more rules that define matches between system attributes 
and profiles. See profile. 


A generated version of the rules file. It is required by the custom JumpStart 
installation software to match a system to a profile. You must use the check 
script to create the rules.ok file. 


An area on a disk composed of a single range of contiguous blocks. A slice is a 
physical subset of a disk (except for slice 2, which by convention represents the 
entire disk). A disk can be divided into eight slices. Before you can create a file 
system on a disk, you must format it into slices. 
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Solaris installation program 


software group 


standalone system 


subnet 


subnet mask 


swap space 


system types 


time zone 


(1) A menu-driven, interactive program that enables you to set up a system 
and install the Solaris software on it. (2) Any part of the software that is used 
to install the Solaris software on a system. 


A logical grouping of the Solaris software (clusters and packages). During a 
Solaris installation, you can install one of the following software groups: core, 
end user system software, developer system support, or entire distribution. 

A system that has its own root (/) file system, swap space, and /usr file 
system, which reside on its local disk(s); it does not require boot or software 
services from an OS server. A standalone system can be connected to a 
network. 


A working scheme that divides a single logical network into smaller physical 
networks to simplify routing. 

A bit mask, which is 32 bits long, used to determine important network or 
system information from an IP address. 


Disk space used for virtual memory storage when the system does not have 
enough system memory to handle current processes. Also known as the / swap 
or swap file system. 

The different ways a system can be set up to run the Solaris software. Valid 
system types are: standalone system, dataless client, and diskless client, 
AutoClient system, OS server. However, the only system types that are covered 
in this document are standalone system, dataless client, and OS server. 


Any of the 24 longitudinal divisions of the earth's surface for which a standard 
time is kept. 
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upgrade option 


An option presented during the Solaris installation program. The upgrade 
procedure merges the new version of Solaris with existing files on your disk(s), 
and it saves as many local modifications as possible since the last time Solaris 
was installed. 


/usr 


/var 


A file system on a standalone system or server that contains many of the 
standard UNIX programs. A dataless client must share (mount) /usr from a 
file server; it does not have its own /usr file system. Sharing the large /usr 
file system with a server rather than maintaining a local copy minimizes the 
overall disk space required to install and run the Solaris software on a system. 


A file system or directory (on standalone systems) containing system files that 
are likely to change or grow over the life of the system. These include system 
logs, vi files, mail files, and uucp files. 


Volume Management 

A program that provides a mechanism to administer and obtain access to the 
data on CD-ROMs and diskettes. 
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Symbols 

- (minus sign) 

in begin and finish scripts 111 
in rules 87 

! (exclamation mark) rule field 84 
# (pound sign) 
in profiles 68 
in rules 87 

&& (ampersands) rule field 84 
... (ellipsis points) rule field 84 
= (equals sign) in profile field 98 
> prompt, changing to ok prompt 127, 133 
[] (brackets) rule field 84 
\ (backslash) in rules 87 

Numerics 

386 system. See x86 systems 
486 systems. See x86 systems 

A 

/a/var/sadm/install_ 

data/upgrade_cleanup file 
137-138 

/a/var/sadm/install_ 

data/upgrade_log file 137 


access to JumpStart directory, enabling 49, 
65-67 

add_install_client command 

custom JumpStart example 166, 167- 
168 

example 38-39 
install server setup 37-39 
JumpStart directory access 65, 67 
syntax 38 
adding 

See also creating 

clusters when upgrading 73 

dataless clients for network 

installation 31-33, 36-37 
files with finish scripts 101 
install server configuration 
information 37-39 
locale . org_dir table entries 44 
OS servers for network installation 
31-33, 35, 37 

packages from software groups 80 
peripheral devices after installation 
143 

profile keywords to profiles 68 
rules to rules file 83-84 
software after installation 141 
standalone systems for network 
installation 31-34, 37 
systems to network 142 



addresses, specifying 21 
administering file systems 142 

all 

location value for fdisk 74 
size value for fdisk 75 
size value for filesys77 
alternative installation programs 111 
ampersands (&&) rule field 84 
AND rule field 84 

angle bracket (>) prompt, changing to ok 
prompt 127, 133 
AnswerBooks, installing 142 

any 

rule keyword 

description and values 88 
example 86 

root disk matching 92 
slice value for f ilesys 77 
arch rule keyword 88 
architecture. See platforms 
auto size value for f ilesys 77 
auto_install_sample directory 
check script 94 

copying files to JumpStart directory 
58, 62, 64 

set_root_pw finish script 102-104 
AutoClient systems 

custom JumpStart installation 
completion 136 
described 7 
identification labels 

SPARC systems 155-157 
x86 systems 155-?? 
interactive installation completion 
130 

Solaris already installed on OS server 
8 

auto-install. See custom JumpStart 
installation 

automounted file system symbolic links, 
preserving 116 


-b option of setup_install_server 

command 29, 167 
backing up 

before installing Solaris 11 
before upgrading 115 
backslash ( \ ) in rules 87 
banner command 21 
begin rule field 
described 85 
valid entries 87 
validation 93 
begin scripts 

creating derived profiles with 98-99 
overview 98 
permissions 98 
rule field 85 

site-specific installation programs 111 
begin . log file 98 
binary compatibility package profile 
example 71 

boot diskette. See Solaris boot diskette 
boot server 

creating on subnet 27-29 
described 18 

requirement for network installation 
18-19, 22 

specifying for network installation 
OS servers 35 
standalone systems 34 
boot: cannot open /kernel/unix 
message 171 
booting the system 

boot file documentation 142 
custom JumpStart installation 133- 
135 

I/O interrupt error messages 21 
interactive installation 127-128 
JumpStart installation 123 
resetting terminals and display first 
21 

troubleshooting 
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boot: cannot open 

/kernel /unix message 
171 

disaster recovery when booting 
from CD 176 

file just loaded does not 
appear to be 
executable message 
171-172 

general installation problems 174, 
176 

rebooting after failed upgrade 
176 

Timeout waiting for 
ARP/RARP packet 

message 172 

WARNING: getfile: RPC 

failed: error 5: RPC 
Timed out message 66, 
173 

wrong server boots 174 
upgrade installation and boot file 
location 115, 171 

boo tp a rams file 

enabling JumpStart directory access 
66 

updating 174 

Bourne shell scripts in rule fields 85 
See also begin scripts; finish scripts 
brackets [] rule field 84 
buses supported 9 

c 

C locale name 44 
-c option 

add_ins tal l_c 1 i ent command 38, 
166, 168 

pf install command 106 
caddy (CD-ROM), using 

custom JumpStart installation 132 
interactive installation 126 
JumpStart installation 122 
cannot open /kernel /unix message 

171 


case of profile keywords and values 68 
cat command 

multiple disk configuration file 
creation 

SPARC systems 109-111 
cd command. See changing directories 
CD, See Solaris CD 
CD-ROM drives 

booting from 128, 134 
documentation 142 
installation on systems without CD- 
ROM drives 17-18 
requirement for Solaris installation 9 
troubleshooting 

disaster recovery when booting 
from CD 176 

file just loaded does not 
appear to be 
executable message 
171-172 

No network boot server 

message 170 

prom_panic: Could not 
mount filesystem 

message 171 

using 

custom JumpStart installation 
132 

interactive installation 126 
JumpStart installation 122 
changing directories 

to JumpStart directory 94 
to mounted CD 62, 64 
to Solaris CD image on local disk 57, 
61, 64 

check script 

comments and 87 
derived profiles and 99 
directory for 94 
rules file validation 49, 93-95 
custom JumpStart example 165 
derived profiles and 99 
rules . ok file creation 93 
testing rules 94 
Chinese locale value 79 
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class action script did not 
complete successfully 

message 171 

client_arch profile keyword 72 
client_root profile keyword 72 
client_swap profile keyword 72 
clients, dataless or diskless. See dataless 
clients; diskless clients 
clock gained xxx days message 172 
clock, time zones for setting 177-178 
cluster profile keyword 
description and values 73 
examples 69-71 

commands for network installation 21 
comments 

in profiles 68 
in rules file 87 

common problems. See troubleshooting 
concatenating multiple disk configuration 
files 

SPARC systems 109-111 
configuring 

disk configuration file creation 
multiple disks 109-111 
SPARC systems 107-108 
hands-off network installation 
requirements 20 

hardware and peripheral devices x 
peripheral devices 

after installation 143 
preconfiguring 

default locale for network 
installation 40-45 
hands-off network installation- 
requirements 20 

preserving software configurations 
during upgrade installation* 
114 

copying 

boot information with setup_ 
install_server 167 
disk configuration file to JumpStart 
directory 107 


JumpStart directory files using finish 
scripts 101 

JumpStart installation files from CD 
58, 62, 64 

Solaris boot diskette 

using Volume Management 54- 
55, 59-60 

without Volume Management 
56-57, 60-61 

Solaris CD to install server's local 
disk 21, 22, 25 

Core System Support software 
cluster name 73 
hard disk space required 10 
cost-effective installation method 11 
Could not mount filesystem 
message 171 
cp command 

See also copying 

copying disk configuration file to 
JumpStart directory 107 
copying JumpStart directory files 
using finish scripts 101 
copying JumpStart installation files 
from CD 64 

creating JumpStart directory 162 
CPUs (processors) 
rule keywords 88 
creating 

See also adding 

boot server on subnet 27-29 

disk configuration files 

SPARC multiple disks 109-111 
SPARC systems 107-108 
/etc/ locale file 42 
install server 22-26 

new system setup 22-23 
overview 22 
procedure 24-26 
JumpStart directory 49 

diskette for SPARC systems 59-62 . 
diskette for x86 systems 53-58 
server 62-65 
local file systems 77-78 
profiles 49, 67-68 
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derived 98-99 
rules file 49, 82-85 
rules . ok file 49, 82, 87, 93 
UFS file system 60 
crontabs documentation 142 
. cshrc file 102 

custom JumpStart installation 131-136 
See also JumpStart directory; 

JumpStart installation 
advantages 11, 48 
AutoClient systems 136 
booting and installing 131-136 
booting the system 133-135 
CD-ROM drive preparation 132 
completing the upgrade 137-138 
installation process 135 
starting OpenWindows 136 
task map 15 
dataless clients 136 
defined 47 
described 11-12 
diskless clients 136 
examples 161-168 

booting and installing 168 
check script 165 
eng_prof ile creation 163 
engineering systems setup 166 
JumpStart directory creation 162 
JumpStart directory sharing 163 
marketing systems setup 167-168 
marketing_prof ile creation 
164 

networked 52 
non-networked 51 
rules file editing 164-165 
site setup 161-162 
standalone system 51 
hands-off installation 
described 11 
requirements 20 
JumpStart directory 38 
No network boot server message 
170 

optional features 97-111 
begin scripts 98-99 


finish scripts 100-104 
overview 97 

pf install command 104—106 
site-specific installation 
programs 111 
overview 50-52 
preparing 47-95 

enabling JumpStart directory 
access 65-67 

installation process 50-52 
JumpStart directory creation on 
server 62-65 

JumpStart directory on diskette 
for SPARC systems 59-62 
JumpStart directory on diskette 
for x86 systems 53-58 
profile creation 67-68 
profile examples 69-71 
profile keywords and value 
descriptions 72-81 
rootdisk value 91-93 
rule examples 86 
rule keywords and value 
descriptions 88-91 
rules file creation 82-85 
rules file information 87 
rules file validation 93-95 
swap size 82 
tasks 49 
profile server 

OS servers 35 
standalone systems 34 
task map 15 

D 

-D option of pf install command 105 
-d option of pf install command 106 
daemons 

tf tpd 174 
dataless clients 

custom JumpStart installation 
completion 136 
described 7 

f ilesys profile keyword 76 
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future Solaris releases (after 2.5) and 8 
interactive installation completion 
130 

network installation server setup 30- 
37 

host, adding 36 
install server setup 37-39 
name service selection 32 
overview 31 

server support needed 30 
OpenWindows not available 175 
software requirements 8 
system identification labels 
SPARC systems 155-157 
x86 systems 155-?? 
upgrade installation 115 
dd command 54-55, 56-57 
See also copying 
de locale name 44, 79 
decimal fdisk partition type 75 
defaults 

derived profile name 99 
locale 

preconfiguring using NIS name 
service 40-42 

preconfiguring using NIS+ name 
service 43-45 
partitioning 81 

designating disks 81 
excluding disks 74 

SI_CONFIG_DIR variable setting 101 
software group installed 73 
delete fdisk partition type 75 
deleting 

clusters when upgrading 73 
fdisk partitions 75 
packages from software groups 80 
software after installation 141 
derived profiles 98-99 
DeskSet software 10 
desktop, displaying 136 

interactive installation 130 
JumpStart installation 123 
Developer System Support software 


cluster name 73 
hard disk space required 10 
Developer System Support software 
profile example 69 
device access documentation 143 
df -a command 114 
df stab file 63, 163 
directories 
changing 

to JumpStart directory 94 
to mounted CD 58, 62, 64 
to Solaris CD image on local disk 
57, 61, 64 

JumpStart 

adding files with finish scripts 
101 

copying files 101, 107 
copying installation files from 
CD 58, 62, 64 
creating 49, 162 

creating for SPARC systems 59- 
62 

creating for x86 systems 53-58 
enabling access 49, 65-67 
file name truncation 58 
install server setup 38 
permissions 53, 63 
rules file example 83 
sharing 63, 163 

disaster recovery when booting from CD 
176 

See also troubleshooting 
disk configuration files 

copying to JumpStart directory 107 
creating 

SPARC multiple disks 109-111 
SPARC systems 107-108 
described 104, 107 

disk drives. See CD-ROM drives; diskette 
drives; hard disks 
diskette drives 

documentation 142, 143 
diskettes 

copying Solaris boot diskette 


194 


SPARC: Installing Solaris Software— November 1995 



using Volume Management 54- 
55, 59-60 

without Volume Management 
56-57, 60-61 

ejecting 

SPARC systems 55 
x86 systems 55, 56 
formatting 55, 56, 60, 61 
JumpStart directory 
access 65 

creating for SPARC systems 59- 
62 

creating for x86 systems 53-58 
mounting 57, 61 
diskless clients 

custom JumpStart installation 
completion 136 
described 7 

interactive installation completion 
130 

OpenWindows not available 175 
platforms 72 

Solaris already installed on OS server 
8 

swap space 72 
system identification labels 
SPARC systems 155-157 
x86 systems 155-?? 
disksize rule keyword 

description and values 88 
root disk matching 92 
display 

interface for interactive installation 
129 

resetting after I/O interrupts 21 
tip line connection and interactive 
installation 127 

displaying 

mounted file systems 21 
platform name 21 
system information 21, 142 
distribution software group profile 
examples 70 

DNS (Domain Name Service) 32 


documentation needed after installation 
141-143 

Domain Name Service (DNS) 32 
doma inname rule keyword 88 
domains 

default locale 42 
rule keyword 88 
dontuse profile keyword 
description and values 74 
usedisk and 81 
DOSHUGE fdisk partition 74 
DOSOS12 fdisk partition 74 
DOSOS16 fdisk partition 74 
dosprimary fdisk partition type 74 

E 

ejecting diskettes 

SPARC systems 55 
x86 systems 55, 56 
ellipsis points (...) rule field 84 
enabling JumpStart directory access 49, 
65-67 

End User AnswerBook 142 
End User System Support software 
cluster name 73 
hard disk space required 10 
eng_prof ile example 163 
English locale value 44 
Entire distribution plus OEM support 
software 
cluster name 73 
Entire distribution software 
cluster name 73 

equals sign (=) in profile field 98 
erasing. See deleting 
error messages 

See also troubleshooting 

boot: cannot open 

/kernel/unix 171 
Error: Unknown client 170 
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file just loaded does not 
appear to be 
executable 171-172 
I/O interrupts 21 

leO: No carrier - transceiver 
cable problem 170 
No network boot server 170 
pkgrm: ERROR: class action 
script did not 
complete successfully 

171 

prom_panic: Could not mount 
filesystem 171 

Timeout waiting for ARP/RARP 
packet 172 

WARNING: clock gained xxx days 

172 

WARNING: getfile: RPC failed: 
error 5 : RPC Timed out 

66, 173 

Error: Unknown client message 170 
es locale name 44, 79 
/etc files, updating NIS or NIS+ tables 66 
/etc/bootparams file 

enabling JumpStart directory access 
66 

updating 174 

/etc/df s/df stab file 63, 163 
/etc/locale file 42 
/etc/mnttab file and UFS file system 
existence 60 

/etc/resolv. conf file 32 
/etc /shadow file 103 
/etc/vf stab file 
mount options 78 
preventing file systems from 

mounting during upgrade 
117 

Ethernet addresses 
displaying 21 
specifying 21 

Ethernet networks. See network 

installation; networked systems 
exclamation mark ( I ) rule field 84 


executing. See starting 

existing 

partitioning value 81 
size value for filesys77 
explicit, partitioning value 81 


failed upgrade 

cleaning up 137-138 
rebooting problems 176 
fdf ormat command 55, 56, 60, 61 
fdisk profile keyword 

description and values 74-75 
example 70 

file just loaded does not appear 
to be executable message 
171-172 

file servers for dataless clients 36 
files and file systems 
administration 142 
begin scripts output 98 
boot file documentation 142 
copying 

JumpStart directory files using 
finish scripts 101 
JumpStart installation files from 
CD 58, 62, 64 

Solaris boot diskette using 

Volume Management 54- 
55, 59-60 

Solaris boot diskette without 

Volume Management 56- 
57, 60-61 

creating local file systems 77-78 
displaying mounted file systems 21 
finish scripts output 100 
mounting remote file systems 76 
names on PCFS file systems 58 
preserving data 
existing data 78 
preventing mounting during 
upgrade 117 
symbolic links 116 
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unpreserved local modifications 
during upgrade 137-138 
remote access 142 
troubleshooting 

file just loaded does not 
appear to be 
executable message 
171-172 

prom_panic: Could not 
mount filesystem 

message 171 

UFS file system creation 60 
f ilesys profile keyword 

description and values 76-78 
examples 69-70 
local file systems 77-78 
remote file systems 76 
finish rule field 
described 85 
valid entries 87 
validation 93 
finish scripts 100-104 

adding files using 101 
defined 100 

important information 100 
output 100 
permissions 100 

root environment customization 102 
root password setting 102-104 
rule field 85 

site-specific installation programs 111 
uses 100 

finish, log file 100 
floppy disks. See diskettes 
floppy drives 

documentation 142, 143 
format utility documentation 143 
formatting diskettes 55, 56, 60, 61 
f r locale name 44, 79 
free size value for f ilesys 77 
French locale value 44, 79 


G 

German locale value 44, 79 
getfile: RPC failed: error 5: 

RPC Timed out message 66, 173 
graphics monitor. See display 
Greenwich Meantime map 178 
groups, See software groups 

H 

halting a system 142 
hands-off installation 

See also custom JumpStart installation 
described 11 
requirements 20 
hard disks 

copying Solaris CD to install server 
22, 25 

documentation 143 

interfaces supported 9 

local disks in networked systems 7 

managing use 142 

mounting 

displaying mounted file systems 
21 

remote file systems 76 
partitioning 

deleting fdisk partitions 75 
designating for partitioning 
default 81 
examples 69-70 
excluding for partitioning 
default 74 
profile keyword 81 
requirements for Solaris installation 
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root disk values 77, 91-93 

setting up 143 
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rule keywords 88, 91 
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swap space 

diskless client 72 
maximum size 82 
networked systems 7 
profile examples 69, 70 
upgrade installation and full disk 114 
hard links, unpreserved local 
modifications 138 
hardware 

See also peripheral devices; specific 
hardware 
configuring x 

platform names and groups by 
system 159-160 
platforms supported 9 
requirements 9 

hexadecimal fdisk partition type 75 
host 

adding for network Solaris 
installation 34-36 
name 38, 89 
Host Manager 
adding hosts 

dataless clients 36 
OS servers 35 
standalone systems 34 
custom JumpStart installation 
completion 136 
described 21 

interactive installation completion 
130 

name service selection 32 
hostaddress rule keyword 88 
hostname rule keyword 

description and values 89 
example 86 

i 

I/O interrupt error messages 21 
initial installation 

See also preparing for Solaris 
installation 

custom JumpStart installation 131— 
136 


advantages 11 
AutoClient systems 136 
booting the system 133-135 
CD-ROM drive preparation 132 
dataless clients 136 
described 11-12 
diskless clients 136 
installation process 135 
starting Open Windows 136 
task map 15 

install_type profile keyword 78 
interactive installation 125-130 
advantages 11 
AutoClient systems 130 
booting the system 127-128 
CD-ROM drive preparation 126 
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described 11-12 
diskless clients 130 
installation process 128-129 
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task map 14 

tip line connection and 127 
JumpStart installation 119-123 
advantages 11 
booting the system 123 
CD-ROM drive preparation 122 
checking for new system 120 
Customer Information sheet 120 
described 11-12 
installation process 123 
selecting software to install 121 
starting OpenWindows 123 
task map 13 

upgrade installation vs. 113 
work sheet 146-150 

install patches and upgrade installation 
114 

install server 

copying Solaris CD to local disk 21, 22, 
25 

creating 22-26 

new system setup 22-23 
overview 22 
procedure 24-26 
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described 18 

network installation setup 37-39 
on subnet other than system to be 
installed 26-29 

requirement for network installation 
18-19 

specifying for network installation 
OS servers 35 
standalone systems 34 
system types applicable 22 
install_conf ig command 66 
install_type profile keyword 
description and values 78 
examples 69-??, 71, ??-71 
requirement 67, 69 
testing profiles 104, 105-106 

creating disk configuration files 
107-?? 

Installation Notes xi 
installed rule keyword 
description and values 89 
rootdisk matching 92 
installing AnswerBooks 142 
Installing Solaris 
how to use ix 
intended audience ix 
organization x-?? 
related information xi 
installing Solaris software 

See also custom JumpStart installation; 
interactive installation; 
JumpStart installation; 
preparing for Solaris 
installation; upgrade 
installation 
booting phase 3 
choosing a method 11-12, 48 
defined 1 

documentation needed after 
installation 141-143 
interactive vs. automatic installation 3 
overview 

diagram 2-3 
task maps 12-15 

site-specific installation programs 111 


work sheets 145-153 

initial installation 146-150 
purposes and uses 145 
shaded areas 145 
upgrade installation 151-153 
Integrated Drive Electronics (IDE) 
interface, See IDE interface 
interactive installation 125-130 
See also preparing for Solaris 
installation 
advantages 11 
AutoClient systems 130 
booting the system 127-128 
CD-ROM drive preparation 126 
completing an upgrade 137-138 
dataless clients 130 
described 11-12 
diskless clients 130 
installation process 128-129 
starting OpenWindows 130 
task map 14 

tip line connection and 127 
IP addresses 

rule keyword 88 
specifying 21 

IPI interface, requirement 9 
it locale name 44, 79 
Italian locale value 44, 79 

I 

j a locale name 79 
Japanese locale value 79 
JumpStart directory 

adding files with finish scripts 101 
copying files 

disk configuration files 107 
installation files from CD 58, 62, 
64 

using finish scripts 101 
creating 49 

diskette for SPARC systems 59-62 
diskette for x86 systems 53-58 
example 162 
server 62-65 
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enabling access 49, 65-67 
file name truncation 58 
install server setup 38 
permissions 53, 63 
rules file example 83 
sharing 62-65, 163 
JumpStart installation 

See also custom JumpStart installation 
advantages 11 

booting and installing 119-123 
booting the system 123 
CD-ROM drive preparation 122 
checking for new system 120 
Customer Information sheet 120 
installation process 123 
selecting software to install 121 
starting OpenWindows 123 
task map 13 
described 11-12 
task map 13 


K 

karch rule keyword 89 
kernel architecture. See platforms 
kernel location and upgrade installation 
115, 171 

keywords. See profile keywords; rule 
keywords 
ko locale name 79 
Korean locale value 79 


L 

labels, system identification 
SPARC systems 155-157 
x86 systems 155-?? 
language (locale) 

preconfiguring using NIS name 
service 40-42 

preconfiguring using NIS+ name 
service 43-45 

Latin America locale value 44, 79 

leO: No carrier - transceiver 
cable problem message 170 


links 

hard 

unpreserved local modifications 
during upgrade 138 

symbolic 

preserving during upgrade 116 
unpreserved local modifications 
during upgrade 138 
local disks. See hard disks 
locale file 42 
locale profile keyword 

description and values 79 
example 71 
locale, default 

preconfiguring using NIS name 
service 40-^2 

preconfiguring using NIS+ name 
service 43-45 

locale . org_dir table, adding entries 44 
log files 

begin scripts output 98 
finish scripts output 100 
upgrade installation 137 
logical AND rule field 84 

M 

mail accounts, setting up 141 
mail directory 116 
make command 42 
Makefile file 41 
man pages 69, 71 
maps, task 

custom JumpStart installation 15 
interactive installation 14 
JumpStart installation 13 
marketing_prof ile example 164 
matching 

derived profiles 99 
order for rules 83, 86 
root disk values 91-93 
maxfree size value for fdisk 75 
memory 

displaying amount installed 21 
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minimum required 9 
rule keyword 86, 89 
setting size 105 
swap space size and 82 
virtual 9 

memsize rule keyword 

description and values 89 
example 86 

messages. See troubleshooting 
microprocessors 

rule keywords 88 
minus sign (-) 

in begin and finish scripts 111 
in rules 87 
mkdir command 63 

mnttab file and UFS file system existence 
60 

model name, displaying 21 
model rule keyword 

description and values 90 
example 86 

modem documentation 143 
monitor, See display 
mount command 21, 61 
mounting 

begin script caution 98 
diskettes 57, 61 

displaying mounted file systems 21 
OpenWindows file system 175 
remote file systems 76 
Solaris CD 24, 27, 58, 62, 64 
by Solaris installation 100 
multiple disk configuration file 
SPARC systems 109-111 
multiple lines in rules 87 

N 

name server 18-19 
name service 

See also NIS; NIS+ 

Error: Unknown client message 
170 


hands-off network installation 
requirements 20 
selecting 23 

selecting for network Solaris 
installation 32 
specifying 21 
names /naming 

See also name service 
derived profile names 99 
host name 38, 89 
PCFS file name truncation 58 
profile names 68 
rules file 83, 87 
software group cluster names 73 
system model names 90 
system platform name determination 
21, 159 

network installation 

See also custom JumpStart installation; 
dataless clients; diskless 
clients; interactive 
installation; JumpStart 
installation 

custom JumpStart installation 
example 52 
task map 15 
described 17 

interactive installation task map 14 
JumpStart installation task map 13 
preparing 17-45 

boot server creation 27-29 
commands available 21 
hands-off installation 
requirements 20 
install server creation 22-26 
preconfiguring default locale 40- 
45 

server setup 30-39 
servers required 18-19 
speeding up installations 22 
prom_panic : Could not mount 
filesystem message 171 
network number 91 
network rule keyword 

description and values 91 
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example 86 
networked systems 

determining if connected 6 
types 6-8 

news directory 116 
NIS 

default locale preconfiguration 40-42 

Error: Unknown client message 
170 

name service selection 32 
selecting 23 

Timeout waiting for ARP/RARP 
packet message 172 
updating tables corresponding to 
/etc files 66 

NIS+ 

default locale preconfiguration 43-45 

Error: Unknown client message 
170 

name service selection 32 
selecting 23 

Timeout waiting for ARP/RARP 
packet message 172 
updating tables corresponding to 
/etc files 66 

NIS+ and DNS Setup and Configuration 
Guide 23 

nistbladm command 43-44 
No carrier - transceiver cable 
problem message 170 
No network boot server message 170 
num_clients profile keyword 79 

o 

ok prompt, changing from > prompt 127, 
133 

opening. See starting 
openwin command 

custom JumpStart installation 136 
interactive installation 130 
JumpStart installation 123 
troubleshooting 175 
Open Windows software 


hard disk space requirements 10 
not available to diskless or dataless 
clients 175 

starting 

custom JumpStart installation 
136 

interactive installation 130 
JumpStart installation 123 
OS servers 

described 7, 18 

drive requirements for Solaris 
installation 9 

network installation server setup 
host, adding 35 
install server setup 37-39 
name service selection 32 
overview 31 

network installation setup 30-37 
server support required 30 
requirement for network installation 
18-19 

Solaris already installed 8 
system identification labels 
SPARC systems 155-157 
x86 systems 155-?? 
osname rule keyword 91 
output files 

begin scripts log 98 
finish scripts log 100 
upgrade log 137 
overlap value for f ilesys 78 

p 

-p option of check script 94 
package profile keyword 
description and values 80 
examples 69, 71 
partitioning 

deleting fdisk partitions 75 
designating disks 81 
examples 69-70 
excluding disks 74 
fdisk partitions 70, 74-75 
profile keyword 81 
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partitioning profile keyword 
description and values 81 
designating disks 81 
PASSWD variable 103 
password, root 102-104 
paths 

check script 94 
install server setup 38 
relative, for symbolic links 116 
PCFS file systems, file name truncation 58 
performance, increasing 142 
peripheral devices 

adding after installation 143 
configuring x 

maintaining after installation 143 
permissions 

begin scripts 98 
finish scripts 100 
JumpStart directory 53, 63 
pf install command 104-106 
See also disk configuration files 
disk configuration files 
described 104 

SPARC multiple disks 109-111 
SPARC systems 107-108 
options 105-106 
profile testing 105-106 
uses 104 

pkgrm: ERROR: class action 

script did not complete 
successfully message 171 
platform groups 159-160 
platforms 

diskless client 72 
group determination 159 
install server setup 38 
matching system attributes and 
profiles 82, 83, 86 
name determination 21, 159 
rule keywords 89 
selecting software to install 121 
supported 9 
system model names 90 


table of names and groups by system 
159-160 
pound sign (#) 
in profiles 68 
in rules 87 

preconfiguring. See configuring 
preparing for Solaris installation 

custom JumpStart installation 47-95 
advantages 11, 48 
described 11-12 
enabling JumpStart directory 
access 65-67 
example 161-168 
installation process 50-52 
JumpStart directory creation on 
server 62-65 

JumpStart directory on diskette 
for SPARC systems 59-62 
JumpStart directory on diskette 
for x86 systems 53-58 
profile creation 67-68 
profile examples 69-71 
profile keywords and value 
descriptions 72-81 
rootdisk value 91-93 
rule examples 86 
rule keywords and value 
descriptions 88-91 
rules file creation 82-85 
rules file information 87 
rules file validation 93-95 
swap size 82 
tasks 49 

importance of preparation 5 
interactive installation 
advantages 11 
described 11-12 
JumpStart installation 
advantages 11 
described 11-12 
network preparation 17-45 
boot server creation 27-29 
commands available 21 
hands-off installation 
requirements 20 
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install server creation 22-26 
preconfiguring default locale 40- 
45 

server setup 30-39 
servers required 18-19 
system preparation 5-15 
backing up 11 

choosing installation method 11- 
12 

disk space requirement 9-11 
hardware requirements 9 
network connection 

determination 6 
system type determination 6-8 
task maps (installation) 12-15 
tasks (preparatory) 5 
upgrade installation 113-117 
backing up 115 

determining upgrade availability 
113-114 

preserving local modifications 
116-117 
work sheets 145-153 

initial installation 146-150 
purposes and uses 145 
shaded areas 145 
upgrade installation 151-153 
preserve value for f ilesys 78 
preserving data 

existing data during installation 78 
preventing file systems from 

mounting during upgrade 
117 

symbolic links 116, 117 
unpreserved local modifications 
during upgrade 137-138 

printers 

See also peripheral devices 
setting up 142 

problems. See troubleshooting 
processors 

rule keywords 88 
profile keywords 72-81 
adding to profiles 68 
case sensitivity 68 


client_arch 72 
client_root 72 
client_swap 72 
cluster 

description and values 73 
examples 69-71 

dontuse 

description and values 74 

usedisk and 81 
fdisk 

description and values 74-75 
example 70 

f ilesys 

description and values 76-78 
examples 69-70 
local file systems 77-78 
remote file systems 76 
install_type 

description and values 78 
examples 69-??, 71, ??-71 
requirement 67, 69 
locale 

description and values 79 
example 71 

num_clients 79 
package 

description and values 80 
examples 69, 71 
partitioning 

description and values 81 
designating disks 81 
examples 69-70 
excluding disks 74 
system__type 

description and values 81 
examples 69-70 
usedisk 

description and values 81 

dontuse and 74 

profile server for custom JumpStart 
installation 
OS servers 35 
standalone systems 34 
profiles 

comments in 68 
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creating 49, 67-68 
derived profiles 98-99 
described 49, 67 
examples 69-71 

eng_prof ile 163 
marketing_prof ile 164 
matching systems to 82, 83, 86 
naming 68 
requirements 67, 68 
rule field 85 
testing 105-106 

disk configuration files 107-?? 
prom__panic: Could not mount 
filesystem message 171 
prtconf command 90 
prtvtoc command 

SPARC disk configuration file 
creation 107-108 

ps -ef I grep tftpd command 174 

R 

-r option of check script 94 
RAM, See memory 
recovery procedure 176 
release of Solaris software 
determining 114 
installed rule keyword 89 
os name rule keyword 91 
remote file systems 
accessing 142 
mounting 76 

remote Solaris installation. See network 
installation 

removing. See deleting 
requirements 

hard disk space 9-11 
hardware 9 
network installation 

hands-off configuration 20 
servers 18-19, 22 
profiles 67, 68 
reset command 21 


resetting display and terminal after I/O 
interrupts 21 
resolv . conf file 32 
restoring the root file system 176 
root ( / ) file systems 

determining existence 114 
networked systems 7 
profile example 70 
restoring (disaster recovery) 176 
value set by installation program 91- 
93 

root environment, customizing 102 
root password, setting 102-104 
rootdisk 
defined 91 

slice value for filesys 77 
value set by installation program 91- 
93 

rootdisk fdisk partition 74 
RPC failed: error 5: RPC Timed 
out message 66, 173 
RPC Timed out message 66, 173 
rule keywords 88-91 
any 

description and values 88 
example 86 

rootdisk matching 92 
arch 88 
disksize 

description and values 88 
rootdisk matching 92 
doma inname 88 
hostaddress 88 
hostname 86, 89 
installed 

description and values 89 
rootdisk matching 92 
karch 89 
memsize 86, 89 
model 86, 90 
network 86, 91 
osname 91 
totaldisk 91 
validation 93 
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rulejceyword rule field 84 
rulejualue rule field 84, 87 
rules 

derived profiles 98-99 
examples 86 
field descriptions 84-85 
matching order 83, 86 
multiple line rules 87 
rootdisk matching rules 91-93 
syntax 84 
testing validity 94 
rules file 

adding rules 83-84 
comments 87 
creating 49, 82-85 

custom JumpStart example 164-165 

described 49, 82 

example 83 

multiple line rules 87 

naming 83, 87 

syntax 84 

testing rules 94 

validating using check 49, 93-95 
custom JumpStart example 165 
derived profiles and 99 
rules . ok file 

comments and 87 
creating 49, 82, 87, 93 
described 87 

matching order for rules 83, 86 
running. See starting 

s 

-s option of add_install_client 
command 38, 167 

saving data during installation. See 
preserving data 
/sbin/setup_cd script 176 
Sbus, requirement 9 
scripts 

See also check script; finish scripts 

begin scripts 98-99, 111 

Bourne shell scripts in rule fields 85 


finish scripts 100-104, 111 
for disaster recovery when booting 
from CD 176 

network installation commands 21 

pkgrm: ERROR: class action 
script did not 
complete successfully 

message 171 

SCSI interface, requirement 9 
security 

documentation 142 
root password 102-104 
serial port documentation 143 
servers 

See also boot server; install server; OS 
servers 

file servers for dataless clients 36 
JumpStart directory creation 62-65 
name server 18-19 
network installation setup 

dataless client installation 31-33, 
36-37 

OS server installation 31-33, 35, 
37 

standalone installation 31-34, 37 
profile server for custom JumpStart 
installation 34, 35 

requirements for network installation 
18-19 

root space 72 

service access facility documentation 143 
set_root_pw finish script 102-104 
setup. See configuring; preparing for 
Solaris installation 
setup_cd script 176 
setup_install_server command 
boot server setup 29 
custom JumpStart example 167 
described 21 
install server setup 25 
shaded areas in work sheets 145 
shadow file 103 
share command 

sharing JumpStart directory 63, 163 
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sharing OpenWindows file system 
175 

shareall command 64, 163 
sharing 

JumpStart directory 63, 163 
OpenWindows file system 175 
S I_CONF I G_D I R variable 101 
SI_PROFILE environment variable 99 
SI_SYS_STATE variable 103 
site-specific installation programs 111 
size 

fdisk partition 75 
hard disk 

root space 72 
rule keywords 88, 91 
space available 25, 29 
space required 9-11 
local file system 77 
memory 86, 89, 105 
swap space 

diskless client 72 
maximum size 82 
profile examples 69, 70 
tip window dimensions 127 
slices 

f ilesys values 77 
profile examples 69-70 
rule keyword 89 

Small Computer System Interface (SCSI), 
requirement 9 

SMD interface, requirement 9 
software groups 

cluster names for profiles 73 
profile examples 69-71 
specifying packages 80 
upgrading 73 

software. See Solaris software; third party 
software 

Solaris 1.x to Solaris 2.x Transition Guide xi 
Solaris boot diskette 

copying using Volume Management 
54-55,59-60 

copying without Volume 

Management 56-57, 60-61 


Solaris CD 

copying to install server's local disk 
21, 22, 25 

displaying mounted file systems 21 
image on local disk 57, 61, 64 
inserting into local drive 

custom JumpStart installation 
132 

interactive installation 126 
installation on systems without CD- 
ROM drives 17-18 
mounting 24, 27, 58, 62, 64 
software contained 2 
troubleshooting 

disaster recovery when booting 
from CD 176 

file just loaded does not 
appear to be 
executable message 
171-172 

No network boot server 

message 170 

prom_panic: Could not 
mount filesystem 

message 171 

Solaris fdisk partition type 74, 75 
Solaris software 

See also Solaris CD 

adding after installation 141 

groups 

cluster names for profiles 73 
profile examples 69-71 
specifying packages 80 
upgrading 73 

hard disk space requirements 9-11 
platforms supported 9 
release or version 
determining 114 
installed rule keyword 89 
os name rule keyword 91 
Solstice AdminSuite 2.1 User's Guide xi 
Solstice AutoClient 1.0 Administration Guide 
8 

solstice program. See Solstice System 
Management Base 
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Solstice System Management Base 
documentation 143 
Host Manager 21, 32 
starting 31 

Solstice System Management Base 2.1 User's 
Guide 8 
SPARC systems 

hardware requirements 9 
JumpStart directory creation on 
diskette 59-62 

platform names and groups 159-160 
platforms supported 9 
speeding network installations 22 
square brackets [] rule field 84 
standalone systems 

custom JumpStart installation 
example 51 
described 7 
identification labels 

SPARC systems 155-157 
x86 systems 155-?? 
network installation server setup 30- 
37 

host, adding 34 
install server setup 37-39 
name service selection 32 
overview 31 

server support needed 30 
networked and non-networked 
systems 8 

profile examples 69-70 
Standard Time zones 177-178 
starting 

check script 94-95 
OpenWindows software 

custom JumpStart installation 
136 

interactive installation 130 
JumpStart installation 123 
Solstice System Management Base 31 
tf tpd daemon 174 
stopping a system 142 
stty command 127 
subnet 


boot server creation on 27-29 
install server and 26 
SunOS 4.x systems 

custom JumpStart installation task 
map 15 

interactive installation task map 14 
platform names and groups 159 
upgrading 113 
SUNWCall group 73 
SUNWCprog group 73 
SUNWCreq group 73 
SUNWCuser group 73 
SUNWCXall group 73 
sv locale name 44, 79 
swap file systems 

diskless client swap space 72 
memory size and 82 
networked systems 7 
profile examples 69, 70 
size determination 82 
swap value for f ilesys 78 
Swedish locale value 44, 79 
symbolic links 

preserving during upgrade 116 
unpreserved local modifications 
during upgrade 138 
S Y S_MEMS I Z E variable 105 
system accounting utilities profile 
example 70 

System Administration Guide, Volume I xi 
system architecture. See platforms 
system boot. See booting the system 
system identification labels 
SPARC systems 155-157 
x86 systems 155-?? 
system information, displaying 21 
system types 6-8 

See also platforms 
system_type profile keyword 
description and values 81 
examples 69-70 
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T 

Taiwanese locale value 79 
tape drive documentation 143 
task maps 

custom JumpStart installation 15 
interactive installation 14 
JumpStart installation 13 
terminals 

documentation 143 
resetting after I/O interrupts 21 
testing 

profiles 105-106 

disk configuration files 107-?? 
validating rules files 

custom JumpStart example 165 
derived profiles and 99 
testing rules 94 
using check 49, 93-95 
tf tpd daemon 174 
third party software, adding 141 
time zones 177-178 
timed out RPC error 173 
Timeout waiting for ARP/RARP 
packet message 172 
tip line connection and interactive 
installation 127 
totaldisk rule keyword 91 
transceiver cable problem message 
170 

troubleshooting 169-?? 
boot: cannot open 

/kernel /unix message 171 
booting from wrong server 174 
disaster recovery when booting from 
CD 176 

Error: Unknown client message 
170 

failed upgrade 137-138 

file just loaded does not 
appear to be 
executable message 171- 
172 

general installation problems 


booting the system 174, 174-??, 
176 

OpenWindows doesn't start 175 
rebooting after failed upgrade 
176 

I/O interrupt messages 21 

leO : No carrier - transceiver 
cable problem message 
170 

No network boot server message 
170 

pkgrm: ERROR: class action 
script did not 
complete successfully 

message 171 

prom_panic: Could not mount 
filesystem message 171 
Timeout waiting for ARP/RARP 
packet message 172 
WARNING: clock gained xxx days 
message 172 

WARNING: get file: RPC failed: 
error 5 : RPC Timed out 

message 66, 173 
truncated file names 58 

u 

UFS file system 
creating 60 

determining existence of 60 

Unable to install the system 

message 170 

uname - i command 21, 159 
uname -m command 159 
Unknown client error message 170 
unnamed value for filesys 78 
unshareall command 64, 163 
upgrade installation 

See also preparing for Solaris 
installation 
completing 137-138 
custom JumpStart installation 131- 
136 

AutoClient systems 136 
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booting the system 133-135 
CD-ROM drive preparation 132 
completing the upgrade 137-138 
dataless clients 136 
diskless clients 136 
installation process 135 
starting Open Windows 136 
task map 15 
dataless clients 115 
failed upgrade 137-138, 176 
hard disk full 114 
initial installation vs. 113 
install patches and 114 
interactive installation 125-130 
AutoClient systems 130 
booting the system 127-128 
CD-ROM drive preparation 126 
completing the upgrade 137-138 
dataless clients 130 
diskless clients 130 
installation process 128-129 
starting OpenWindows 130 
task map 14 

tip line connection and 127 
log file 137 

overriding boot file location 115, 171 
preparing 113-117 
backing up 115 

determining upgrade availability 
113-114 

preserving local modifications 
116-117 

preserving other software 
configurations 114 
profile example 71 
profile keywords 
cluster 71, 73 
install_type 71, 78 
locale 71, 79 
package 71, 80 
SunOS 4.x systems and 113 
unpreserved local modifications 137- 
138 

work sheet 151-153 

upgrade_cleanup file 137-138 


upgrade_log file 137 
usedisk profile keyword 
description and values 81 
dontuseand 74 
user accounts, setting up 142 
/usr file systems 7 
/usr/bin/solstice program. See 
Solstice System Management 
Base 

/usr/openwin/bin/openwin 

command 

custom JumpStart installation 136 
interactive installation 130 
JumpStart installation 123 
troubleshooting 175 

/usr /sbin/ install . d/pf install 
command. See pf install 

command 

v 

validating 

profiles 105-106 

disk configuration files 107-?? 
rules files 

custom JumpStart example 165 
derived profiles and 99 
testing rules 94 
using check 49, 93-95 
/var/ma.il directory 116 
/var/news directory 116 
/var/sadm/begin . log file 98 
/var/sadm/ finish . log file 100 
/var/sadm/install_data/upgrade_ 
cleanup file 137-138 
/var/sadm/ ins tall_data/upgrade_ 
log file 137 

/var/yp/make command 42 
/var/yp/Makef ile file 41 
variables 

PASSWD 103 
S I_CONF I G_D I R 101 
SI_PROFILE 99 
SI_SYS_STATE 103 
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SYS_MEMSIZE 105 

version of Solaris software 
determining 114 
installed rule keyword 89 
osname rule keyword 91 
vf stab file 

mount options 78 
preventing file systems from 

mounting during upgrade 
117 

virtual memory requirements 9 
See also swap file systems 
VMEbus, requirement 9 
vo 1 check command 54, 59, 60 
Volume Management 

changing directory to mounted CD 
58, 64 

copying 

JumpStart installation files from 
CD 58 

Solaris boot diskette 54-55, 59-60 
determining whether running 24, 28 
mounting diskettes 57 
Solaris CD file path and 24, 28 


z 

zh locale name 79 
zh_TW locale name 79 
zones, time 177-178 


WARNING: clock gained xxx days 
message 172 
work sheets 145-153 

initial installation 146-150 
purposes and uses 145 
shaded areas 145 
upgrade installation 151-153 
wrapping lines in rules 87 


x86 systems 

file name truncation 58 
JumpStart directory creation on 
diskette 53-58 

platform name and group 159 
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Revision History 


Release Date Comments 

Solaris 2.5 November 1995 Change to Service Setup For Clients During Installation 

The Solaris installation program (interactive and custom JumpStart) 
no longer sets up services for clients. During installation, selecting 
the system type 'OS server' only allocates space for clients; to 
complete client set up you must use Solstice Host Manager after 
Solaris software is installed. 

New bootparams Keyword/Value 

A new bootparams key word / value forces sysidtool to attempt to 
configure a specified name service (overriding the default NIS+), 
thus enabling clients to be set up for off-subnet servers. See 

bootparams(4). 

The bootparams keyword /value has the following syntax: 
ns= [server] : nameservice [ ( netmask ) ] 

This addition affects the etc /bootparams file, Solstice Host 
Manager, and add__install_client script (where -n <ns_string> 
is the string to put in the bootparams table). 

Change of Location of Diskless Client Booting Information 

Information on how to boot diskless clients has been moved to the 
System Administration Guide , Volume I 



Release 


Comments 


Date 

Solstice Host Manager Replaces add_install_client 

The Solstice Host Manager now supports remote installations, and 
is the recommended tool for setting up network install servers 
(instead of the add_install_client command). Solstice Host 
Manager can also now be used to set up custom JumpStart 
installations. 

Hardware Support Dropped 

The sun4 and sun4e hardware is no longer supported in Solaris 2.5 

Underlying Software Changes 

The /usr/kvm directory is replaced by the /usr/platform 
directory. Servers no longer have to export /usr/kvm for each 
supported platform, and clients do not have to mount the exported 
/usr/kvm directory appropriate for their platform. With 
/usr/platform, the same exported /usr file system can support 
all platforms. 

The terms, kernel architecture and architecture, have been replaced by 
the terms platform name (for example SUNW,S240), and platform 
group (for example, sun4m). 

Solaris 2.4 October 1994 Book Rewrite 

The System Configuration and Installation Guide was rewritten. 
Procedures for installing Solaris software for x86 and SPARC were 
separated into two books and the titles changed to: x86: Installing 
Solaris Software and SPARC: Installing Solaris Software. 

New Interfaces For Interactive Installations 

New graphical user interface (GUI) and character user interface 
(CUI) were added for installing Solaris software. 


SPARC: Installing Solaris Software — November 1995 
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